---
title: "Set or clear the agent's 3D body finish (« skin »)"
method: PATCH
path: "/agents/{id}/finish"
tags: ["Agents"]
---

# Set or clear the agent's 3D body finish (« skin »)

`PATCH /agents/{id}/finish`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/agents/{id}/finish`
- Auth: HTTP bearer

Owner of the agent, or an admin of the owner's company. A plain teammate (who can still view and chat with the agent) gets 404. `finish: null` clears it (back to carbone). Purely visual: nothing is pushed to the agent and nothing is journalled; the floor re-reads it from GET /floor/state.

## Path parameters

- `id` string, required

## Request body

- object
  - `finish` 'carbone' | 'chrome-studio' | 'titane' | 'candy' | 'nacre-ormeau' | 'velours' | 'ceramique' | 'marbre' | 'terrazzo' | 'cuir' | 'jade' | 'maille' | 'mercure' | 'lave' | 'eau' | 'glace' | 'malachite' | 'labradorite' | 'calacatta' | 'noyer' | 'soie' | 'ecailles', nullable, required

## Response `200`

- object
  - `finish` string, nullable

## Other responses

- `400`: FINISH_INVALID / finish required (an id or null)
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: Unknown agent, or the caller is neither its owner nor an admin of the owner's company.

---

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