v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-22495670.8 KB
Clones

Regenerate clone headshot

Triggers asynchronous headshot regeneration for a clone. Returns immediately with 202 Accepted. Poll GET /clones/{cloneId}/profile and check state.headshot for progress.

An optional request body can include additionalInstructions to nudge the appearance (e.g. "longer hair", "wearing glasses"). An empty body performs a standard regeneration.

post/public/v1/clones/{cloneId}/headshot/generate

Path parameters

cloneIdstring required

Request body

additionalInstructionsstring

Optional instructions to nudge the generation (e.g. "deeper voice", "longer hair")

Response

Generation started

statusstring required

Example response

{
  "status": "generating"
}