Composable context retrieval - query selected memory types in parallel

Prod Env

POST

/v1/magickspaces/{id}/context

Supports an optional x-api-key header (Bearer token format) for API-key-scoped access.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠4XX

🔴5XX

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/magickspaces//context' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "chat_history": {
        "limit": 20
    },
    "corpus": {
        "query": "string"
    },
    "participant_id": "string",
    "pelican": {
        "query": "string"
    }
}'

Response Example

200 - Example 1

{
    "chat_history": [
        {
            "content": "string",
            "create_at": "string",
            "id": "string",
            "magickspace_id": "string",
            "message_type": "string",
            "reply_to_message_id": "string",
            "sent_by_user_id": "string",
            "status": "string",
            "update_at": "string"
        }
    ],
    "corpus": [
        {
            "content": "string"
        }
    ],
    "fetcher": "string",
    "magickspace_id": "string",
    "participant_id": "string"
}

Delete a magick space

Join the LiveKit room of a magick space