ReferenceSpaces

Ask a space

Runs an agent scoped to one space.

It can search the space's knowledge, traverse the graph and read conversation history before answering.

Scope is enforced server-side from the credential — a space-scoped key cannot read outside its space, whatever the request body says.

POST
/api/v1/memory/space/{space_id}/ask

Authorization

x-api-key<token>

A platform key (ck_live_…) — reaches every memory in the tenant.

In: header

Path Parameters

space_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/api/v1/memory/space/spc_7f3a91/ask" \  -H "Content-Type: application/json" \  -d '{    "question": "string"  }'
{  "answer": "string",  "citations": [    {      "index": 0,      "title": "string",      "source": "string",      "document_id": "string",      "snippet": "string",      "url": "string"    }  ],  "conversation_id": "string"}
Was this page helpful?
Report an issue