Made in 10Docs
GuidesAPI
ReferenceCharacters

Get one version

One version.

GET
/characters/{character_id}/versions/{n}

Authorization

secretKey
headerAuthorizationBearer <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.

Path Parameters

character_id*string

The character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
n*integer

A version number (1 is the first).

Range1 <= value

Response Body

The version.

application/json
  1. response

A version with the character as it was and what changed.

Example
{  "n": 7,  "note": "Warmer greeting",  "how": "api",  "restored_from": null,  "by": "API key server",  "changed": [    "greeting"  ],  "created_unix": 1793300000,  "current": true,  "calls": 23}
n*integer
Range1 <= value
note*string
how*string

created: made; saved: saved in the dashboard while not live (or changed by the builder); updated: a dashboard draft put live; api: a PATCH; restored: an older version made current.

Value in"created""saved""updated""api""restored"
restored_from*|

The version its fields came from, after a restore.

by*string

Who made it (a person's name, or the API key's), or empty when unknown.

changed*array<string>

The fields that differ from the version before (empty for v1).

created_unix*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
current*boolean

Calls run on it now.

calls*integer

How many calls ran on it.

character*

Every field as it was (name, role, greeting, instructions, knowledge, language, face_id, voice_id, tier, max_call_seconds, record, silence_check_seconds, silence_end_seconds) and the assets it took (document_ids, guardrail_ids, pronunciation_ids, tool_ids).

changes*array<>
previous*|

The version it is compared with; null for v1.

Example Request
curl -X GET 'https://api.daxov.com/v1/characters/chr_4fT9kQ2mXw7LbN3pZs8V/versions/1'
Example Response
{  "n": 7,  "note": "Warmer greeting",  "how": "api",  "restored_from": null,  "by": "API key server",  "changed": [    "greeting"  ],  "created_unix": 1793300000,  "current": true,  "calls": 23,  "character": {},  "changes": [    {      "field": "string",      "before": null,      "after": null    }  ],  "previous": 0}