latestOpenAPI 3.0.02026-08-19219210532.7 KB

bd5a5f406bca

cms

List available avatars

get/api/v1/avatars

Query parameters

idsstring[] nullable

Array of IDs to filter results. To skip this filter, omit the key entirely from your JSON. Never write the bare word undefined (that is invalid JSON). Empty arrays and null are also treated as omission.

pagenumber

Page number starting from 1.

limitnumber

Limit for the number of results per page.

orderobject

Order configuration as a key-value object where keys are field names and values are "ASC" or "DESC".

gender'male' | 'female'

Filter avatars by gender

age'young' | 'middle-aged' | 'senior'

Filter avatars by age bracket

reusableboolean

Filter avatars by reusability for AI-generated personas

sagaIdstring

Filter avatars by saga — returns global avatars (no saga) plus avatars restricted to this saga

Response