AdnovaDocs
Creative Hub

List tags

Returns the workspace's assignable Creative Hub tags (soft-deleted tags omitted). Pass ?q= to filter by tag name (case-insensitive substring). Use a tag's _id with PATCH /files/{fileId} (tagsToAdd / tagsToRemove) or POST /files/bulk/tags.

GET
/tags

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Query Parameters

q?string

Case-insensitive substring match against the tag name.

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint).

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/creative-hub/v1/tags?q=hero" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P"
{
  "tags": [
    {
      "_id": "01H8YT...",
      "name": "Hero",
      "color": "#FF5722",
      "disabled": false
    }
  ]
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}