Personas

List Personas

post

Personas are the characters that can be used to ask questions about a brand. They are used to get AI answers with citations and mentions.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

Body

application/json

brand_kit_idintegerRequired

The ID of the Brand Kit

sortstring · enumOptional

Sort field. Prefix with - for descending.

Available sort fields:

• title/-title: Sort alphabetically by persona title
• 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}/personas/list

HTTPcURLJavaScriptPython

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

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

{
  "data": [
    {
      "id": 1,
      "title": "text",
      "description": "text",
      "created_at": "text",
      "updated_at": "text"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

Get Persona

get

Personas are the characters that can be used to ask questions about a brand. They are used to get AI answers with citations and mentions.

Authorizations

bearer

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}/personas/{id}

HTTPcURLJavaScriptPython

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

{
  "data": {
    "id": 1,
    "title": "text",
    "description": "text",
    "created_at": "text",
    "updated_at": "text"
  }
}