Generate an agent avatar
POST /v1/agents/{id}/avatar/generate - admin-triggered xAI image
generation. The optional prompt describes the desired look; it seeds the
subject and is wrapped in the house illustration style + safety rails, then
the image is stored in Trove and set as the agent’s avatar_url.
Synchronous (a few seconds). The cost is absorbed by the platform
(provider_usage.paid_by='platform'). Admin only.
Authorizations
Personal Access Token. Send as Authorization: Bearer hq_pat_....
Path Parameters
Agent id
Body
Optional free-text look description (e.g. "calm, approachable, soft blue palette"). Seeds the SUBJECT only - it's wrapped server-side in the house flat-vector illustration style + no-real-likeness / no-demographic-marker safety rails, never used as the raw prompt. Omitted = the default house style from the agent's name + description.