- Documentation
- Bifrost
- API Keys
- Artifacts
- Auth
- Blueprints
- Centrifugo
- Cortex
- MagickMind
- Corpus
- List corpora
- Create a corpus
- Add artifacts to a corpus
- Finalize a client-side artifact upload into a corpus
- List ingestion statuses for all artifacts in a corpus
- Remove an artifact from a corpus
- Get the ingestion status of a corpus artifact
- Query a corpus for relevant content
- Get a corpus by id
- Update a corpus
- Delete a corpus
- End Users
- Episodes
- List the authenticated service user's episodes (paginated)
- Get all graph edges (related + chronological) among a mindspace's episodes, scoped to the authenticated service user
- Search episodes (mindspace-scoped if mindspace_id set, else user-wide), scoped to the authenticated service user
- Get a single episode by id, scoped to the authenticated service user
- MagickSpaces
- Send a message to a magick space (internal, HMAC-signed)
- List magick spaces
- Create a magick space
- Get a magick space by id
- Update a magick space
- Delete a magick space
- Composable context retrieval - query selected memory types in parallel
- Join the LiveKit room of a magick space
- Mint a LiveKit access token for a magick space
- List messages in a magick space
- Send a message to a magick space
- Add users to a magick space
- MagickMind Chat
- List MagickMind chat sessions
- Create a MagickMind chat session
- Get a MagickMind chat session by id
- Update a MagickMind chat session
- Delete a MagickMind chat session
- Composable context retrieval - query selected memory types in parallel
- List messages in a MagickMind chat session
- Send a message in a MagickMind chat session
- Personas
- List personasGET
- Create a personaPOST
- Create a persona from a blueprintPOST
- Get a persona by idGET
- Update a personaPUT
- Delete a personaDELETE
- Prepare a persona for use (warm caches and resources)POST
- List versions of a personaGET
- Create a persona versionPOST
- Get the active version of a personaGET
- Get a persona versionGET
- Activate a persona versionPOST
- List personas
- Projects
- Runtime
- Traits
- Schemas
Get a persona by id
Prod Env
Prod Env
GET
/v1/persona/{id}
Request
Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************or
Path Params
Responses
🟢200
application/json
Bodyapplication/json
🟠4XX
🔴5XX
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/persona/' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Example 1
{
"active_version": "string",
"artifact_id": "string",
"background_story": "string",
"created_by": "string",
"id": "string",
"name": "string",
"role": "string",
"tones": [
"string"
],
"traits": [
"string"
],
"updated_by": "string"
}