Atmee.aiDocs
APIAPI referenceAvatars

Read the graph conductor of a v2 avatar

GET
/v1/avatars/{avatarId}/conductor

The conductor as saved: the whole graph and speakAfterS. The avatar detail (GET /v1/avatars/{avatarId}) reports only whether one is set and its node count.

Authorization

headerX-Api-Key<token>

Secret embed API key (sk_atmee_...; keys minted before 2026-09 carry sk_live_...), held by the customer's own backend and never sent to a browser. Format: X-Api-Key: sk_atmee_....

Path Parameters

avatarId*string
Formatuuid

Response Body

The conductor.

application/json
  1. response
avatarId*string
Formatuuid
graph*

The steps of the conversation (nodes) and the one it starts in (start). Every node must be reachable from start. Only start, nodes and reasoning are accepted.

speakAfterS?number

As set; absent when it was not (Causeur's default applies, 0.5 today).

Formatdouble
nodes*integer

The graph's node count.

edges*integer

The graph's edge count, all nodes together.

Example Request
curl -X GET 'https://api.atmanity.us/v1/avatars/497f6eca-6276-4993-bfeb-53cbbbba6f08/conductor'
Example Response
{  "avatarId": "ac572b6e-802b-4b9e-a602-0786d4441e67",  "graph": {    "start": "string",    "nodes": [      {        "id": "string",        "instructions": "string",        "edges": [          {            "to": "string",            "when": "string",            "weight": 0.1,            "speak": true          }        ],        "random": true,        "emotion": "string",        "role_play": true,        "languages": [          "string"        ],        "replan": true      }    ],    "reasoning": null  },  "speakAfterS": 0.1,  "nodes": 0,  "edges": 0}

Delete an older version of a v2 avatar DELETE

Deletes every take of an older version and the files only that version uses: its takes' sink latents and preview clips, and its portrait, voice sample, voice clone, prime clip and bundle unless a kept take or the current inputs still use them.

Remove the graph conductor of a v2 avatar DELETE

The next session runs without a conductor, also one the avatar's own config carries (a running session keeps the one it started with).

Read the graph conductor of a v2 avatar — Atmee Docs