API reference
Space is in development. These guides describe the current development version and the intended workflow. Public sign-ups and hosted agent connections are not available yet.
Every route a personal API key can call, with its parameters, fields, errors and an example request.
New to the API? Start with Build with the API to create a key and make a first request, then read API concepts. This reference describes version 0.3.0 of the API.
Build your own client for Space.
Create a personal API key in Settings → API keys and send it on every request as
Authorization: Bearer spk_.... A key acts as you in the one Space it was created for,
with your current role there. A read-only key can read and search; a read-write key can
also create, change and delete content. Keys cannot manage agents, keys, members,
billing, restores or webhooks, and they do not work on the MCP endpoint.
Errors are JSON objects with an error message. Writes take an expected_revision or a
command_id where shown, so a retry never applies twice. Treat a key like a password:
keep it out of public web pages and revoke it in Settings if it leaks.
Authentication
A personal API key (spk_...) created in Settings for one Space. Send it as a bearer token in the Authorization header of every request. Keys start with spk_.
Authorization: Bearer spk_...Base URL
Requests go to your Space API URL, not to this website. Every path in this reference is relative to it. If the Agents page shows https://<api-host>/mcp/, your API URL is https://<api-host>. Find your API URL.
Errors
Errors return a status code and a JSON body. API concepts explains each status and how to retry.
Error
errorstringRequiredA human-readable explanation of what went wrong.
{
"error": "This API key is read-only."
}Space
The key's Space, its map, usage and activity.
- GET
/Get the key's Spacev1/ workspace - GET
/Get the Space read versionv1/ spaces/ {space_id}/ read-version - GET
/Get plan usagev1/ spaces/ {space_id}/ usage - GET
/Get activity overviewv1/ spaces/ {space_id}/ overview - GET
/Get the Space mapv1/ spaces/ {space_id}/ map
Documents and tasks
Documents, tasks and task columns.
- GET
/List documents or tasksv1/ spaces/ {space_id}/ resources - POST
/Create or update a document or taskv1/ spaces/ {space_id}/ resources - GET
/Get a document or taskv1/ spaces/ {space_id}/ resources/ {resource_id} - DELETE
/Delete a document or taskv1/ spaces/ {space_id}/ resources/ {resource_id} - GET
/List task columnsv1/ spaces/ {space_id}/ tasks/ columns - POST
/Add a task columnv1/ spaces/ {space_id}/ tasks/ columns - POST
/Move a taskv1/ spaces/ {space_id}/ tasks/ {resource_id}/ status - POST
/Save a handoffv1/ spaces/ {space_id}/ handoffs
Projects, folders and databases
Workspace items and records.
- GET
/List workspace items of one kindv1/ spaces/ {space_id}/ items - POST
/Create or update a workspace itemv1/ spaces/ {space_id}/ items - GET
/Get a workspace itemv1/ spaces/ {space_id}/ items/ {item_id} - POST
/Query a databasev1/ spaces/ {space_id}/ databases/ {database_id}/ query
Memory
Memory claims, links and extraction jobs.
- GET
/Get a memoryv1/ spaces/ {space_id}/ memories/ {resource_id} - DELETE
/Delete a memoryv1/ spaces/ {space_id}/ memories/ {resource_id} - GET
/Get memory provider detailsv1/ spaces/ {space_id}/ memory/ provider - GET
/List memoriesv1/ spaces/ {space_id}/ memories - GET
/List memory linksv1/ spaces/ {space_id}/ memories/ {resource_id}/ links - PUT
/Set memory linksv1/ spaces/ {space_id}/ memories/ {resource_id}/ links - POST
/Build memory synchronouslyv1/ spaces/ {space_id}/ memory/ build - POST
/Remember structured claimsv1/ spaces/ {space_id}/ memory/ claims - GET
/List memory jobsv1/ spaces/ {space_id}/ memory/ jobs - POST
/Start a memory extraction jobv1/ spaces/ {space_id}/ memory/ jobs - GET
/Get a memory jobv1/ spaces/ {space_id}/ memory/ jobs/ {job_id} - POST
/Remember authored textv1/ spaces/ {space_id}/ memory/ remember - POST
/Edit, classify or forget a claimv1/ spaces/ {space_id}/ memory/ change - POST
/Correct claim attributionv1/ spaces/ {space_id}/ memory/ creator
Search and recall
Full-text search and cited recall.
- POST
/Search the Spacev1/ spaces/ {space_id}/ search - POST
/Recall cited contextv1/ spaces/ {space_id}/ context
Export
Paged export of everything in the Space.
Operations
Service liveness.