Skip to main content
GET
Get a character

Authorizations

Authorization
string
header
required

An app API key, e.g. Authorization: Bearer sk_live_…. Secret (sk_) for writes/sessions; publishable (pk_) is read-only (browser-safe).

Path Parameters

id
string<uuid>
required

Response

The character (owner view, includes the brain)

A character (owner view). The brain (persona/lore) is included for the owning app, but NEVER leaves the server on the embed path.

id
string<uuid>
slug
string | null
name
string
description
string
cover
string | null
visibility
enum<string>
Available options:
private,
unlisted,
public
voiceId
string | null
modelId
string | null
free
boolean
greeting
string | null
intro
object | null
stances
object[]
persona
string
scene
string | null
lore
string | null
examples
string | null
created_at
string<date-time>
updated_at
string<date-time>
schemaVersion
string
Example:

"1.0"