(GET) Get tags
Retrieve tags from your workspace. Filter by tag ID or list all tags with pagination.
Endpoint
GET /tags
Retrieve tags by id. Supports pagination with take, skip, and sorting by tag id.
Use this endpoint to list your tags, verify tag existence, or build tag management interfaces.
Endpoint text
GET /tagsAuthentication
Requires an authorized credential with permission for tagsRead. API keys are one supported credential; eligible OAuth or authenticated sessions may also authorize this operation.
Query Parameters
Request Limits
The `take` parameter supports values from 1 to 5,000. Requests above 5,000 are rejected.
Examples
Request cURL
curl -X GET "https://api.hoko.to/tags?take=50&sort=desc" \
-H "Authorization: Bearer <API_KEY>"Request JavaScript
const response = await fetch('https://api.hoko.to/tags?take=50&sort=desc', {
method: 'GET',
headers: {
Authorization: 'Bearer <API_KEY>'
}
});
const tags = await response.json();Response json
[
{
"id": "<tag_id>",
"name": "Marketing",
"color": "blue"
}
]