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