MagickMind
Documentation
Copy Page
Documentation
Get started
Introduction
Quick Start
First API Call
Core Concepts
Projects
Corpus
Mindspaces
End-Users
Websocket
Authentication
Overview
OAuth Flow
API Keys
Guides
Creating a Corpus
Managing End-Users
SDK
Python
Go
API
v1
Auth
Login
Refresh Token
End-Users
Create End-User
Get End-User by ID
Update End-User
Query End-Users
Delete End-User
Project
Create Project
Get Project by ID
Get Project List
Update Project
Delete Project
Mindspaces
Create Mindspace
Update Mindspace
Get Mindspace by ID
Get Mindspace List
Delete Mindspace
Get Mindspace Messages
Add Mindspace Users by ID
Chat
Magick Mind Chat
Realtime
Websocket Subscribe
Bifrost
API Keys
List API keys
CreateApiKeyHandler
Delete an API key
Artifacts
Create a time-limited presigned URL for a direct-to-S3 artifact upload
S3/Lambda upload-completion webhook (HMAC-signed, server-to-server)
Auth
Request a password reset email
Log in with email and password
Refresh an access token
Reset a password using a reset token
Sign up a new user account
Verify an email address from a verification link
Send an email verification link
Blueprints
List blueprints
Create a blueprint
Get a blueprint by key
Validate a blueprint definition without saving it
Get a blueprint by id
Replace a blueprint
Delete a blueprint
Partially update a blueprint
Clone a blueprint
Get a blueprint with its traits fully resolved
Centrifugo
Centrifugo connect proxy (server-to-server, proxy-secret authenticated)
Centrifugo RPC proxy (server-to-server, proxy-secret authenticated)
Cortex
OpenAI-compatible chat completions via SSE or JSON
MagickMind
MagickMind chat
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
MagickMind chat as an end user (end-user JWT)
List end users with optional filters
Create an end user
Get multiple end users by ids
Mint a scoped JWT for an end user
Get an end user by id
Update an end user
Delete an end user
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 personas
Create a persona
Create a persona from a blueprint
Get a persona by id
Update a persona
Delete a persona
Prepare a persona for use (warm caches and resources)
List versions of a persona
Create a persona version
Get the active version of a persona
Get a persona version
Activate a persona version
Projects
List projects
Create a project
Get a project by id
Update a project
Delete a project
Runtime
Get the effective (resolved) personality of a persona
Invalidate the runtime personality cache
Traits
List traits
Create a trait
Get a trait by id
Replace a trait
Delete a trait
Partially update a trait
Schemas
RequestBodies
v1_PersonaCreatePersonaHandlerBody
v1_AuthForgotPasswordHandlerBody
v1_MagickspacesMagickSpaceLivekitJoinHandlerBody
ErrorResponse
APIError
ValidationError
Documentation
Copy Page
SDK
Previous
Managing End-Users
Next
Python