# Personas

## List Personas

> 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.

```json
{"openapi":"3.0.1","info":{"title":"API V1","version":"v1"},"tags":[{"name":"Personas"}],"servers":[{"url":"https://api.airops.com","variables":{"defaultHost":{"default":"api.airops.com"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"paths":{"/public_api/brand_kits/{brand_kit_id}/personas/list":{"post":{"summary":"List Personas","description":"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.","tags":["Personas"],"operationId":"listBrandKitsPersonas","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"nullable":true,"type":"integer","description":"Unique identifier for the persona"},"title":{"nullable":true,"type":"string","description":"The persona title"},"description":{"nullable":true,"type":"string","description":"The persona description"},"created_at":{"nullable":true,"type":"string","description":"When the persona was created"},"updated_at":{"nullable":true,"type":"string","description":"When the persona was last updated"}}}},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total_count":{"type":"integer"},"total_pages":{"type":"integer"}}}},"required":["data","meta"]}}}},"400":{"description":"Bad request - invalid parameters, filters, or sort options"},"401":{"description":"Unauthorized - invalid or missing authentication token"},"404":{"description":"Not found - resource does not exist"},"412":{"description":"Precondition failed - AEO not configured for this brand kit"}},"parameters":[{"name":"brand_kit_id","in":"path","required":true,"schema":{"type":"integer"},"description":"The Brand Kit ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand_kit_id":{"type":"integer","description":"The ID of the Brand Kit"},"filters":{"type":"array","description":"Filter results.\n\n**Available fields:**\n- **title** (EQUALS, CONTAINS): Filter by persona title","items":{"type":"object","properties":{"field":{"type":"string","enum":["title"],"description":"Field to filter on. title: Filter by persona title"},"operator":{"type":"string","enum":["EQUALS","CONTAINS"],"description":"Filter operator.\n\n- **EQ/EQUALS**: Exact match\n- **NEQ**: Not equal\n- **GT/GEQ/LT/LEQ**: Numeric/date comparisons\n- **CONTAINS**: Partial text match\n- **STARTS_WITH**: Text prefix match\n- **IN**: Match any value in array"},"value":{"description":"Filter value (type depends on field and operator)"}},"required":["field","operator","value"]}},"fields":{"type":"array","description":"Select additional fields to return.\n\n**Optional fields:**\n- **id**: Unique identifier for the persona\n- **title**: The persona title\n- **description**: The persona description\n- **created_at**: When the persona was created\n- **updated_at**: When the persona was last updated","items":{"type":"string","enum":["id","title","description","created_at","updated_at"]}},"sort":{"type":"string","enum":["title","-title","created_at","-created_at"],"description":"Sort field. Prefix with - for descending.\n\n**Available sort fields:**\n- **title/-title**: Sort alphabetically by persona title\n- **created_at/-created_at**: Sort by creation date"},"page":{"type":"integer","default":1,"description":"Page number"},"per_page":{"type":"integer","default":25,"maximum":100,"description":"Items per page"}},"required":["brand_kit_id"]}}}}}}}}
```

## Get Persona

> 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.

```json
{"openapi":"3.0.1","info":{"title":"API V1","version":"v1"},"tags":[{"name":"Personas"}],"servers":[{"url":"https://api.airops.com","variables":{"defaultHost":{"default":"api.airops.com"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"paths":{"/public_api/brand_kits/{brand_kit_id}/personas/{id}":{"get":{"summary":"Get Persona","description":"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.","tags":["Personas"],"operationId":"getBrandKitsPersona","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"nullable":true,"type":"integer","description":"Unique identifier for the persona"},"title":{"nullable":true,"type":"string","description":"The persona title"},"description":{"nullable":true,"type":"string","description":"The persona description"},"created_at":{"nullable":true,"type":"string","description":"When the persona was created"},"updated_at":{"nullable":true,"type":"string","description":"When the persona was last updated"}}}},"required":["data"]}}}},"400":{"description":"Bad request - invalid parameters, filters, or sort options"},"401":{"description":"Unauthorized - invalid or missing authentication token"},"404":{"description":"Not found - resource does not exist"},"412":{"description":"Precondition failed - AEO not configured for this brand kit"}},"parameters":[{"name":"brand_kit_id","in":"path","required":true,"schema":{"type":"integer"},"description":"The Brand Kit ID"},{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The resource ID"}]}}}}
```