# Audiences

## GET /audiences

> Get Audiences

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_AudienceApiResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AudienceApiResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[AudienceApiResponse]"},"AudienceApiResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Members Count"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"lookback_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Window"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"last_synced":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","created_at","updated_at"],"title":"AudienceApiResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences":{"get":{"tags":["Audiences"],"summary":"Get Audiences","operationId":"get_audiences_audiences_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_AudienceApiResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Create Audience

> Create a new audience from API-format filters.\
> \
> The submitted \`\`filters\`\` payload is translated into the legacy\
> \`\`Filters\`\` shape consumed by the audience worker. Both forms are\
> persisted on the audience row so the original API input remains\
> inspectable.\
> \
> Returns the newly-created audience with a \`\`queued\`\` status — the\
> audience worker is invoked asynchronously and will populate members.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceCreateRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Human-readable audience name."},"filters":{"$ref":"#/components/schemas/ApiFilters","description":"Entity-keyed filter payload. Keys: visitors, sessions, pages, buyer_intent, enrichment (nested by source), ml (nested by model). See integrations/api/README.md."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"lookback_window":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Lookback Window","description":"How many days of session history to consider when building the audience.","default":60},"refresh_cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Cron","default":"55 15 * * *"}},"type":"object","required":["name","filters"],"title":"AudienceCreateRequest","description":"Public-API shape for creating an audience.\n\nFilters use the entity-keyed translation layer in\n``integrations.api`` — see ``integrations/api/README.md`` for the full\nfield allowlist and operator reference."},"ApiFilters":{"properties":{"visitors":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Visitors"},"sessions":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Sessions"},"pages":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Pages"},"buyer_intent":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Buyer Intent"},"enrichment":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Enrichment","description":"Nested by enrichment source, e.g. {\"klaviyo\": [...], \"shopify\": [...]}."},"ml":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Ml","description":"Nested by ML model name, e.g. {\"icp\": [...]}."}},"additionalProperties":false,"type":"object","title":"ApiFilters","description":"Top-level filter payload, grouped by entity.\n\nAll lists default to empty so callers only need to populate the entities\nthey actually filter on."},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"AudienceApiResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Members Count"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"lookback_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Window"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"last_synced":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","created_at","updated_at"],"title":"AudienceApiResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences":{"post":{"tags":["Audiences"],"summary":"Create Audience","description":"Create a new audience from API-format filters.\n\nThe submitted ``filters`` payload is translated into the legacy\n``Filters`` shape consumed by the audience worker. Both forms are\npersisted on the audience row so the original API input remains\ninspectable.\n\nReturns the newly-created audience with a ``queued`` status — the\naudience worker is invoked asynchronously and will populate members.","operationId":"create_audience_audiences_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## GET /audiences/{id}

> Get Audience By Id

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceApiResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Members Count"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"lookback_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Window"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"last_synced":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","created_at","updated_at"],"title":"AudienceApiResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}":{"get":{"tags":["Audiences"],"summary":"Get Audience By Id","operationId":"get_audience_by_id_audiences__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## DELETE /audiences/{id}

> Delete Audience

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceApiDeleteResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","name","message"],"title":"AudienceApiDeleteResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}":{"delete":{"tags":["Audiences"],"summary":"Delete Audience","operationId":"delete_audience_audiences__id__delete","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## POST /audiences/{id}/refresh

> Refresh Audience

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceApiRefreshResponse":{"properties":{"audience_id":{"type":"string","title":"Audience Id"},"name":{"type":"string","title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["audience_id","name"],"title":"AudienceApiRefreshResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}/refresh":{"post":{"tags":["Audiences"],"summary":"Refresh Audience","operationId":"refresh_audience_audiences__id__refresh_post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiRefreshResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## GET /audiences/{id}/members

> Get Audience Members

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_AudienceApiMemberResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AudienceApiMemberResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[AudienceApiMemberResponse]"},"AudienceApiMemberResponse":{"properties":{"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"personal_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal City"},"married":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Married"},"company_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Phone"},"company_sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Sic"},"company_employee_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Employee Count"},"un_processed_timestamp":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Un Processed Timestamp"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"personal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal State"},"income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Income Range"},"professional_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address2"},"company_naics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Naics"},"primary_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Industry"},"un_updated_timestamp":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Un Updated Timestamp"},"business_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email"},"personal_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip"},"net_worth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Net Worth"},"professional_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional City"},"company_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Address"},"business_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email Validation Status"},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobile Phone"},"personal_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip4"},"homeowner":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Homeowner"},"professional_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional State"},"company_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company City"},"business_email_last_seen":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Business Email Last Seen"},"hem":{"type":"string","title":"Hem"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"personal_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"professional_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip"},"company_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company State"},"personal_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email Validation Status"},"record_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Uuid"},"personal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address"},"personal_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Phone"},"seniority_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"professional_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip4"},"company_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Zip"},"personal_email_last_seen":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Personal Email Last Seen"},"personal_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address2"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"},"age_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Range"},"professional_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_revenue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Revenue"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"last_session_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Session Date"},"last_session_exit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Exit Url"},"last_session_entry_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Entry Url"},"last_session_entry_referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Entry Referer Url"},"total_session_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Session Count"},"last_session_est_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Session Est Duration"},"last_session_total_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Session Total Pages Visited"},"lead_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Category"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"}},"type":"object","required":["hem"],"title":"AudienceApiMemberResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}/members":{"get":{"tags":["Audiences"],"summary":"Get Audience Members","operationId":"get_audience_members_audiences__id__members_get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_AudienceApiMemberResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getuntitled.ai/api-documentation/audiences.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.