Restore a version
Publishes version `n`'s fields at once as the character's next version, as a `PATCH` with them would.
secretKeyAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.
character_id*stringThe character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"n*integerA version number (1 is the first).
1 <= valueforce?booleantrue discards a dashboard draft that waits, instead of answering 409 draft_pending.
falseapplication/json- body
note?stringA note for the version this makes, shown in its history.
length <= 200The character as it is now.
application/json- response
A customer's AI person.
{ "id": "chr_4fT9kQ2mXw7LbN3pZs8V", "name": "Alex", "role": "support", "instructions": "You help customers with questions about our product. Answer only from what you know below.", "greeting": "Hi, I'm Alex, an AI assistant for the support team. What can I help you with?", "knowledge": "We open at nine and close at five, Monday to Friday.", "language": "auto", "face_id": "red-office", "voice_id": null, "tier": "standard", "max_call_seconds": 300, "created_unix": 1793300000, "updated_unix": 1793300000, "document_ids": [ "doc_1Qm6Tx3KcW8vRp5ZbN2h" ], "guardrail_ids": [ "grd_8Vb3Np6XqL1sKw9TfM4c" ], "pronunciation_ids": [], "tool_ids": [ "tool_6Mx1Rb8QwT3kNv5LcZ9p" ], "record": true, "silence_check_seconds": 10, "silence_end_seconds": 20, "sees": "off", "people_notes": false, "people_notes_allowed": true, "version": 7, "draft_pending": false, "custom_role": null}id*CharacterIdA character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"name*string1 <= length <= 80role*RoleWhat the character is for. A new character with a role and no words of its own starts from that role's template. interviewer takes no success criteria (see updateAnalysisSettings). On a character that uses one of your organization's custom roles (custom_role), this is set for you and can't be changed: interviewer when the custom role is protected, blank when it isn't.
"blank""support""sales""interviewer""receptionist"custom_role*|The custom role of your organization it uses (GET /roles), or null. Set it with custom_role_id.
instructions*stringYour instructions for the mind, in your words.
length <= 20000greeting*stringThe line it opens the call with.
length <= 500knowledge*stringWhat it knows, straight into the prompt (with its documents, at most 120,000 characters).
length <= 120000language*LanguageThe language the character speaks. auto answers in whatever language the person speaks.
"auto""en""fa""ar""tr""de""fr""es""it""pt""nl""ru""zh""ja""ko""hi"face_id*|One of our faces (GET /catalog), or null for voice only.
voice_id*|A voice id from the catalog, or null for the face's own voice.
tier*stringThe tier it runs on (GET /catalog lists the tiers on offer and their prices).
max_call_seconds*integerThe longest a call with it may run.
30 <= value <= 1800created_unix*UnixUnix seconds, UTC.
int641793300000updated_unix*UnixUnix seconds, UTC.
int641793300000document_ids*array<>The documents it takes, in order.
guardrail_ids*array<>The guardrail sets it takes, in order.
pronunciation_ids*array<>The pronunciation dictionaries it takes, in order.
tool_ids*array<>The tools it may call, in order.
record*booleanWhether its calls are recorded (see Recordings). True unless you switch it off.
silence_check_seconds*integerOn a quiet call: after this many seconds with nobody speaking it asks once if they're still there. 0 for never; otherwise 5 to 120. Meetings don't use it.
10silence_end_seconds*integerThis many seconds after asking, with still nobody speaking, it says goodbye and ends the call (its end_reason is silence).
5 <= value <= 12020sees*SeesWhat the character sees on a call: nothing (the default), a screen the person shares, their camera, or both. It describes what it sees and never infers feelings, intentions, age, ethnicity, religion or health; a face is never matched to a person.
"off""screen""camera""both"people_notes*booleanWhether what it sees may include plain notes about a person (what they wear or hold, a smile as seen), never anything inferred. False by default; never true for an interviewer.
people_notes_allowed*booleanWhether its role allows people_notes at all: false for an interviewer, whose calls describe the screen and objects only (EU AI Act Art. 5(1)(f); candidates count as a workplace).
version*integerThe published version these fields are (GET /characters/{character_id}/versions).
1 <= value7draft_pending*booleanChanges made in the dashboard wait in a draft for Update; a PATCH is then 409 draft_pending unless ?force=true. This api always answers the published character, never the draft.
curl -X POST 'https://api.daxov.com/v1/characters/chr_4fT9kQ2mXw7LbN3pZs8V/versions/1/restore' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "chr_4fT9kQ2mXw7LbN3pZs8V", "name": "Alex", "role": "support", "instructions": "You help customers with questions about our product. Answer only from what you know below.", "greeting": "Hi, I'm Alex, an AI assistant for the support team. What can I help you with?", "knowledge": "We open at nine and close at five, Monday to Friday.", "language": "auto", "face_id": "red-office", "voice_id": null, "tier": "standard", "max_call_seconds": 300, "created_unix": 1793300000, "updated_unix": 1793300000, "document_ids": [ "doc_1Qm6Tx3KcW8vRp5ZbN2h" ], "guardrail_ids": [ "grd_8Vb3Np6XqL1sKw9TfM4c" ], "pronunciation_ids": [], "tool_ids": [ "tool_6Mx1Rb8QwT3kNv5LcZ9p" ], "record": true, "silence_check_seconds": 10, "silence_end_seconds": 20, "sees": "off", "people_notes": false, "people_notes_allowed": true, "version": 7, "draft_pending": false, "custom_role": null}