(GET) Get tags

Retrieve tags from your workspace. Filter by tag ID or list all tags with pagination.

Endpoint

GET /api/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 /api/tags

Authentication

Requires authentication with an API key that has the tagsRead scope.

Query Parameters

Parameter	Type	Required	Description
`id` (query)	string (UUID)	No	Filter by specific tag ID. Returns a single tag if found.
`take` (query)	number	No	Number of results to return (default: 50, min: 1, max: 10,000).
`skip` (query)	number	No	Number of results to skip for pagination (default: 0, min: 0).
`sort` (query)	string	No	Sort order by tag id: "asc" for oldest first, "desc" for newest first (default: "desc").

Request Limits

The `take` parameter supports values from 1 to 10,000. Requests above 10,000 are rejected.

Examples

Request cURL

curl -X GET "https://hoko.to/api/tags?take=50&sort=desc" \
  -H "Authorization: Bearer <API_KEY>"

Request JavaScript

const response = await fetch("https://hoko.to/api/tags?take=50&sort=desc", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <API_KEY>"
  }
});
const tags = await response.json();

Response json

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Marketing",
    "color": "blue"
  }
]