Tags

List Tags

post

Tags are user-defined labels applied to prompts within a Brand Kit. They are typically used to filter analytics by arbitrary groupings (e.g. priority, campaign, theme) that go beyond topics.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

Body

brand_kit_idintegerRequired

The ID of the Brand Kit

sortstring · enumOptional

Sort field. Prefix with - for descending.

Available sort fields:

• name/-name: Sort alphabetically by tag name
• created_at/-created_at: Sort by creation date

Possible values:

pageintegerOptional

Page number

Default: 1

per_pageinteger · max: 100Optional

Items per page

Default: 25

Responses

200

Successful response

application/json

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

post/public_api/brand_kits/{brand_kit_id}/tags/list

POST /public_api/brand_kits/{brand_kit_id}/tags/list HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "brand_kit_id": 1,
  "filters": [
    {
      "field": "name",
      "operator": "EQUALS",
      "value": null
    }
  ],
  "fields": [
    "id"
  ],
  "sort": "name",
  "page": 1,
  "per_page": 25
}

{
  "data": [
    {
      "id": 1,
      "name": "text",
      "color": "text"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

Get Tag

get

Tags are user-defined labels applied to prompts within a Brand Kit. They are typically used to filter analytics by arbitrary groupings (e.g. priority, campaign, theme) that go beyond topics.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

idintegerRequired

The resource ID

Responses

200

Successful response

application/json

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

get/public_api/brand_kits/{brand_kit_id}/tags/{id}

GET /public_api/brand_kits/{brand_kit_id}/tags/{id} HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "id": 1,
    "name": "text",
    "color": "text"
  }
}