API Reference

Tags API

Get tags for a workspace

URL

https://contioreach.com/api/public/tags

Method

GET

Query Parameters

Parameter	Type	Description
`id`Optional	string	Filter tags by ID
`slug`Optional	string	Filter tags by slug

Authentication

API requests require authentication using an API key in one of two ways:

x-api-key header

Include your API key in the x-api-key header

headers: {
  'x-api-key': 'YOUR_API_KEY'
}

authorization header

Include your API key in the authorization header with format: Bearer YOUR_API_KEY

headers: {
  'authorization': 'Bearer YOUR_API_KEY'
}

Response

200Success

{
  tags: [
    { 
      id: string,
      name: string,
      slug: string
    }
  ]
}

401Unauthorized

{
  error: string // Authentication error message
}

500Server Error

{
  error: "Failed to fetch tags"
}

Usage Examples

Fetch all tags

async function fetchTags() {
  const response = await fetch('https://contioreach.com/api/public/tags', {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  });
  return await response.json();
}

Fetch tag by slug

async function fetchTagBySlug(slug) {
  const response = await fetch('https://contioreach.com/api/public/tags?slug=' + slug, {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  });
  return await response.json();
}