Skip to main content
POST
Generate an agent avatar

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Path Parameters

id
string<uuid>
required

Agent id

Body

application/json
prompt
string | null

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.

Response

The new avatar URL

agent_id
string<uuid>
required
avatar_url
string
required