---
title: "Generate Agent Appearance"
method: POST
path: "/api/agents/{agent_id}/generate-appearance"
tags: ["agents"]
---

# Generate Agent Appearance

`POST /api/agents/{agent_id}/generate-appearance`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/agents/{agent_id}/generate-appearance`
- Auth: HTTP bearer

Kick off appearance generation in the background. Returns 202 immediately.
Poll GET /api/agents/{agent_id} and check character_json.appearance_status
for 'generating', 'done', or 'failed'.

When skip_headshot=true, keeps the existing headshot and only generates
frontview/backview using the headshot as reference.

## Path parameters

- `agent_id` string, uuid, required

## Request body

- SkipHeadshotRequest
  - `skip_headshot` boolean

## Response `202`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)