API reference / Space guide

Memory

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.

Memory claims, links and extraction jobs.

Send every request to your API URL with your key, as described in the reference overview. Read API concepts for paging, safe retries, revisions and errors.

GET `/v1/spaces/{space_id}/memories/{resource_id}`

Get a memory

One memory record with its claims and whether its sources changed.

Path parameters

space_idstring (uuid)Required
resource_idstring (uuid)Required

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
stalebooleanRequired
True when a cited source has changed since.
import_originobject or null
1 field in import_origin
- {key}any
  Any other key.
claimsarray of objectRequired
13 fields in claims
- idstring (uuid)Required
  The claim's entry_id, used to edit or forget it.
- indexstringRequired
  A short label for the claim.
- valuestringRequired
  The claim's exact text.
- memory_typestringRequired
  One of factual, procedural
- importanceintegerRequired
  0 to 3
- editedbooleanRequired
- created_atstring (date-time)Required
- classificationobjectRequired
  6 fields in classification
  - scopestringRequired
    One of global, project, unassigned
  - category_idsarray of string (uuid)Required
  - project_idsarray of string (uuid)Required
  - section_idsarray of string (uuid)Required
  - methodstringRequired
    How the assignment was made, such as manual or typesafe.
  - reasonstringRequired
- creatorobjectRequired
  3 fields in creator
  - kindstringRequired
    One of human, agent
  - basisstringRequired
    How the creator is known, such as captured or assigned.
  - agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
- relationshipsobject or null
  2 fields in relationships
  - statusstringRequired
  - linksarray of objectRequired
- generated_valuestring or null
  The original wording, present once a claim was edited.
- routes_toarray of string (uuid) or null
  Containers this claim governs, from the Space map.
- sourcestring or null
  In memory listings: the cited source resource ID, or the author kind.

Example response

{
  "author": "you",
  "author_agent": null,
  "author_client_id": null,
  "claims": [
    {
      "classification": {
        "category_ids": [],
        "method": "unassigned",
        "project_ids": [],
        "reason": "uncertain",
        "scope": "unassigned",
        "section_ids": []
      },
      "created_at": "2026-10-08T01:56:07.876587+00:00",
      "creator": {
        "agent": null,
        "basis": "captured",
        "kind": "human"
      },
      "edited": false,
      "id": "400f9a95-be1a-5386-bfbb-47ceb37ab434",
      "importance": 0,
      "index": "Atlas launch window",
      "memory_type": "factual",
      "relationships": {
        "links": [],
        "status": "disabled"
      },
      "source": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
      "value": "Atlas launches in November."
    }
  ],
  "folder": null,
  "id": "3bd12481-05da-4243-9c3b-cc453fd74a31",
  "kind": "document",
  "priority": null,
  "project": null,
  "recall": {
    "category": "memory",
    "excluded": false,
    "sources": [
      {
        "resource_id": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
        "revision": 2
      }
    ],
    "topics": []
  },
  "revision": 1,
  "stale": false,
  "status": "todo",
  "title": "Memory: Atlas launch window",
  "updated_at": "2026-10-08T01:56:07.904882+00:00"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl "https://<api-host>/v1/spaces/{space_id}/memories/{resource_id}" \
  -H "Authorization: Bearer $SPACE_API_KEY"

DELETE `/v1/spaces/{space_id}/memories/{resource_id}`

Delete a memory

Permanently deletes a memory record with all its claims. To remove one claim, use the change route with action: forget.

Path parameters

space_idstring (uuid)Required
resource_idstring (uuid)Required

Query parameters

expected_revisionintegerRequired
At least 1

Responses

200Success

deletedbooleanRequired
Always true

Example response

{
  "deleted": true
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X DELETE "https://<api-host>/v1/spaces/{space_id}/memories/{resource_id}?expected_revision=1" \
  -H "Authorization: Bearer $SPACE_API_KEY"

GET `/v1/spaces/{space_id}/memory/provider`

Get memory provider details

Which model provider processes memory, and the state of the index.

Path parameters

space_idstring (uuid)Required

Responses

200Success

enabledbooleanRequired
providerstringRequired
indexobject or null
4 fields in index
- claimsintegerRequired
- memoriesintegerRequired
- other_modelintegerRequired
  Claims indexed by a different embedding model.
- enginestringRequired
{key}any
Any other key.

Example response

{
  "classification_provider": "typesafe",
  "embedding_dim": 1536,
  "embedding_endpoint": "https://models.example.com/v1",
  "embedding_model": "fixture-embed",
  "enabled": true,
  "endpoint": "https://models.example.com/v1",
  "index": {
    "claims": 0,
    "engine": "memora-brain-pgvector-v1",
    "memories": 0,
    "other_model": 0
  },
  "provider": "openai_compatible",
  "relationship_provider": "disabled",
  "relevance_model": "fixture",
  "relevance_provider": "model",
  "text_model": "fixture",
  "typesafe_endpoint": "https://api.typesafe.ai/v1/systemone",
  "typesafe_model": "jev-1.13.0"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl "https://<api-host>/v1/spaces/{space_id}/memory/provider" \
  -H "Authorization: Bearer $SPACE_API_KEY"

GET `/v1/spaces/{space_id}/memories`

List memories

Memory records with their claims, newest first. query filters by words.

Path parameters

space_idstring (uuid)Required

Query parameters

querystring
Default ""
afterstring (uuid) or null
limitinteger
Default 200

Responses

200Success

itemsarray of objectRequired
16 fields in items
- idstring (uuid)Required
- kindstringRequired
  One of document, task
- revisionintegerRequired
  Send this as expected_revision to change it.
  At least 1
- titlestringRequired
- statusstringRequired
  A task column value. Documents report todo.
- updated_atstring (date-time)Required
- authorstringRequired
  "you", "agent", or a teammate's display name in a team Space.
- author_client_idstring (uuid) or nullRequired
  The agent connection that wrote this revision, if an agent did.
- author_agentobject or nullRequired
  5 fields in author_agent
  - idstring (uuid)Required
  - revisionintegerRequired
  - namestringRequired
  - harnessstringRequired
    The agent's software, such as claude, codex or cursor.
  - {key}any
    Any other key.
- projectstring (uuid) or nullRequired
- folderstring (uuid) or nullRequired
- prioritystring or nullRequired
  One of High, Medium, Low
- recallobjectRequired
  4 fields in recall
  - categorystringRequired
    source for documents and tasks, handoff for session handoffs, memory for memory records.
    One of source, handoff, memory
  - topicsarray of stringRequired
  - sourcesarray of objectRequired
    Exact source revisions this item cites.
    2 fields in sources
    resource_idstring (uuid)Required
    revisionintegerRequired
    At least 1
  - excludedbooleanRequired
    True when the item is kept out of recall.
- stalebooleanRequired
  True when a cited source has changed since.
- import_originobject or null
  1 field in import_origin
  - {key}any
    Any other key.
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
next_cursorstring (uuid) or nullRequired
providerobjectRequired
The Space's memory provider. Open: providers report different settings.
4 fields in provider
- enabledbooleanRequired
- providerstringRequired
- indexobject or null
  4 fields in index
  - claimsintegerRequired
  - memoriesintegerRequired
  - other_modelintegerRequired
    Claims indexed by a different embedding model.
  - enginestringRequired
- {key}any
  Any other key.

Example response

{
  "items": [
    {
      "author": "you",
      "author_agent": null,
      "author_client_id": null,
      "claims": [
        {
          "classification": {
            "category_ids": [],
            "method": "unassigned",
            "project_ids": [],
            "reason": "uncertain",
            "scope": "unassigned",
            "section_ids": []
          },
          "created_at": "2026-10-08T01:56:07.876587+00:00",
          "creator": {
            "agent": null,
            "basis": "captured",
            "kind": "human"
          },
          "edited": false,
          "id": "400f9a95-be1a-5386-bfbb-47ceb37ab434",
          "importance": 0,
          "index": "Atlas launch window",
          "memory_type": "factual",
          "source": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
          "value": "Atlas launches in November."
        }
      ],
      "folder": null,
      "id": "3bd12481-05da-4243-9c3b-cc453fd74a31",
      "import_origin": null,
      "kind": "document",
      "priority": null,
      "project": null,
      "recall": {
        "category": "memory",
        "excluded": false,
        "sources": [
          {
            "resource_id": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
            "revision": 2
          }
        ],
        "topics": []
      },
      "revision": 1,
      "stale": false,
      "status": "todo",
      "title": "Memory: Atlas launch window",
      "updated_at": "2026-10-08T01:56:07.904882+00:00"
    },
    {
      "author": "you",
      "author_agent": null,
      "author_client_id": null,
      "claims": [
        {
          "classification": {
            "category_ids": [],
            "method": "unassigned",
            "project_ids": [],
            "reason": "uncertain",
            "scope": "unassigned",
            "section_ids": []
          },
          "created_at": "2026-10-08T01:56:07.311000+00:00",
          "creator": {
            "agent": null,
            "basis": "captured",
            "kind": "human"
          },
          "edited": true,
          "id": "cec465b1-0330-5209-8518-9c4ee6b52841",
          "importance": 0,
          "index": "Launch month",
          "memory_type": "factual",
          "source": "agent",
          "value": "Atlas launches in early November."
        },
        {
          "classification": {
            "category_ids": [],
            "method": "unassigned",
            "project_ids": [],
            "reason": "uncertain",
            "scope": "unassigned",
            "section_ids": []
          },
          "created_at": "2026-10-08T01:56:07.311000+00:00",
          "creator": {
            "agent": null,
            "basis": "user_attributed",
            "kind": "human"
          },
          "edited": false,
          "id": "36976ce0-886b-51af-822f-f3efd5d720d6",
          "importance": 1,
          "index": "Owner",
          "memory_type": "factual",
          "source": "agent",
          "value": "Sam owns the Atlas launch."
        }
      ],
      "folder": null,
      "id": "c2557f17-be42-4b5d-a91f-50477fcf5de7",
      "import_origin": null,
      "kind": "document",
      "priority": null,
      "project": null,
      "recall": {
        "category": "memory",
        "excluded": false,
        "sources": [],
        "topics": []
      },
      "revision": 3,
      "stale": false,
      "status": "todo",
      "title": "Memory: Atlas launch facts",
      "updated_at": "2026-10-08T01:56:07.586955+00:00"
    }
  ],
  "next_cursor": null,
  "provider": {
    "classification_provider": "typesafe",
    "embedding_dim": 1536,
    "embedding_endpoint": "https://models.example.com/v1",
    "embedding_model": "fixture-embed",
    "enabled": true,
    "endpoint": "https://models.example.com/v1",
    "index": {
      "claims": 3,
      "engine": "memora-brain-pgvector-v1",
      "memories": 2,
      "other_model": 0
    },
    "provider": "openai_compatible",
    "relationship_provider": "disabled",
    "relevance_model": "fixture",
    "relevance_provider": "model",
    "text_model": "fixture",
    "typesafe_endpoint": "https://api.typesafe.ai/v1/systemone",
    "typesafe_model": "jev-1.13.0"
  }
}

Errors

401The API key is missing, unknown, expired or revoked. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl "https://<api-host>/v1/spaces/{space_id}/memories" \
  -H "Authorization: Bearer $SPACE_API_KEY"

GET `/v1/spaces/{space_id}/memories/{resource_id}/links`

List memory links

Outgoing links and backlinks, explicit and inferred.

Path parameters

space_idstring (uuid)Required
resource_idstring (uuid)Required

Query parameters

limitinteger
Default 50

Responses

200Success

linksarray of objectRequired
6 fields in links
- entry_idstring (uuid) or nullRequired
- resource_idstring (uuid)Required
- related_entry_idstring (uuid) or nullRequired
- revisionintegerRequired
- relationstringRequired
- originstringRequired
  One of explicit, inferred
backlinksarray of objectRequired
6 fields in backlinks
- entry_idstring (uuid) or nullRequired
- resource_idstring (uuid)Required
- related_entry_idstring (uuid) or nullRequired
- revisionintegerRequired
- relationstringRequired
- originstringRequired
  One of explicit, inferred
has_morebooleanRequired

Example response

{
  "backlinks": [
    {
      "entry_id": null,
      "origin": "explicit",
      "related_entry_id": null,
      "relation": "expands_on",
      "resource_id": "3bd12481-05da-4243-9c3b-cc453fd74a31",
      "revision": 1
    }
  ],
  "has_more": false,
  "links": []
}

Errors

401The API key is missing, unknown, expired or revoked. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl "https://<api-host>/v1/spaces/{space_id}/memories/{resource_id}/links" \
  -H "Authorization: Bearer $SPACE_API_KEY"

PUT `/v1/spaces/{space_id}/memories/{resource_id}/links`

Set memory links

Replaces the memory's explicit links to other memories. An empty list clears them.

Path parameters

space_idstring (uuid)Required
resource_idstring (uuid)Required

Request bodyRequired

command_idstring (uuid)Required
resource_idstring (uuid)Required
expected_revisionintegerRequired
At least 1
linksarray of objectRequired
Up to 20 items
2 fields in links
- resource_idstring (uuid)Required
- relationstring
  One of related, expands_onDefault related

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
bodystringRequired
memoryobjectRequired
3 fields in memory
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
- versionintegerRequired
- linksarray of objectRequired
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstringRequired
    One of related, expands_on

Example response

{
  "author": "you",
  "author_agent": null,
  "author_client_id": null,
  "body": "## Atlas database\nAtlas uses PostgreSQL.",
  "folder": null,
  "id": "a2ad0cf1-3a3b-48ab-9367-adbdd1d3a726",
  "kind": "document",
  "memory": {
    "claims": [
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.262204+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": false,
        "id": "4ffef875-7766-549d-85ea-6fd02d0639ff",
        "importance": 2,
        "index": "Atlas database",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Atlas uses PostgreSQL."
      }
    ],
    "links": [
      {
        "relation": "related",
        "resource_id": "c2557f17-be42-4b5d-a91f-50477fcf5de7"
      }
    ],
    "version": 2
  },
  "priority": null,
  "project": null,
  "recall": {
    "category": "memory",
    "excluded": false,
    "sources": [],
    "topics": []
  },
  "revision": 2,
  "status": "todo",
  "title": "Memory: Atlas database",
  "updated_at": "2026-10-08T01:56:07.431195+00:00"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X PUT "https://<api-host>/v1/spaces/{space_id}/memories/{resource_id}/links" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "command_id": "13fa4532-64f1-4438-a68b-f15faf7eb509",
    "expected_revision": 1,
    "links": [
      {
        "relation": "related",
        "resource_id": "c2557f17-be42-4b5d-a91f-50477fcf5de7"
      }
    ],
    "resource_id": "a2ad0cf1-3a3b-48ab-9367-adbdd1d3a726"
  }'

POST `/v1/spaces/{space_id}/memory/build`

Build memory synchronously

Extracts memory from a saved source right away, using the configured text model. Prefer the jobs route for anything long.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

command_idstring (uuid)Required
sourceobjectRequired
2 fields in source
- resource_idstring (uuid)Required
- revisionintegerRequired
  At least 1
resource_idstring (uuid) or null
expected_revisioninteger
At least 0Default 0

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
bodystringRequired
memoryobjectRequired
3 fields in memory
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
- versionintegerRequired
- linksarray of objectRequired
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstringRequired
    One of related, expands_on

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/memory/build" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "command_id": "6a873255-b075-4ce8-b4b3-047150db601d",
    "source": {
      "resource_id": "d014e80a-06d2-4cc8-864e-15f1929ca81b",
      "revision": 6
    }
  }'

POST `/v1/spaces/{space_id}/memory/claims`

Remember structured claims

Saves claims you already wrote, verbatim: each is classified and indexed, with no text generation. Recallable as soon as this returns.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

command_idstring (uuid)Required
titlestringRequired
1 to 300 characters
linksarray of object
Up to 20 items
2 fields in links
- resource_idstring (uuid)Required
- relationstring
  One of related, expands_onDefault related
claimsarray of objectRequired
1 to 24 items
5 fields in claims
- indexstringRequired
  1 to 300 characters
- valuestringRequired
  1 to 2000 characters
- memory_typestring
  One of factual, proceduralDefault factual
- importanceinteger
  0 to 3Default 0
- routes_toarray of string (uuid)
  Up to 8 items
topicsarray of string
Up to 12 itemsEach item: 1 to 100 charactersEach item: pattern ^[^|\r\n]+$
sourceobject or null
2 fields in source
- resource_idstring (uuid)Required
- revisionintegerRequired
  At least 1
provenanceobject or null
3 fields in provenance
- formatstring
  Always memoraDefault memora
- source_idstringRequired
  1 to 200 characters
- recordobjectRequired
  1 field in record
  - {key}any
    Any other key.

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
bodystringRequired
memoryobjectRequired
3 fields in memory
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
- versionintegerRequired
- linksarray of objectRequired
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstringRequired
    One of related, expands_on

Example response

{
  "author": "you",
  "author_agent": null,
  "author_client_id": null,
  "body": "## Launch month\nAtlas launches in November.\n\n## Owner\nSam owns the Atlas launch.",
  "folder": null,
  "id": "c2557f17-be42-4b5d-a91f-50477fcf5de7",
  "kind": "document",
  "memory": {
    "claims": [
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.311000+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": false,
        "id": "cec465b1-0330-5209-8518-9c4ee6b52841",
        "importance": 0,
        "index": "Launch month",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Atlas launches in November."
      },
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.311000+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": false,
        "id": "36976ce0-886b-51af-822f-f3efd5d720d6",
        "importance": 1,
        "index": "Owner",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Sam owns the Atlas launch."
      }
    ],
    "links": [],
    "version": 2
  },
  "priority": null,
  "project": null,
  "recall": {
    "category": "memory",
    "excluded": false,
    "sources": [],
    "topics": []
  },
  "revision": 1,
  "status": "todo",
  "title": "Memory: Atlas launch facts",
  "updated_at": "2026-10-08T01:56:07.340491+00:00"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/memory/claims" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "claims": [
      {
        "index": "Launch month",
        "value": "Atlas launches in November."
      },
      {
        "importance": 1,
        "index": "Owner",
        "value": "Sam owns the Atlas launch."
      }
    ],
    "command_id": "eee334ff-8b62-4f0c-af7b-6b0cdf65ed25",
    "title": "Atlas launch facts"
  }'

GET `/v1/spaces/{space_id}/memory/jobs`

List memory jobs

Recent memory jobs in this Space.

Path parameters

space_idstring (uuid)Required

Responses

200Success

itemsarray of objectRequired
7 fields in items
- idstring (uuid)Required
- statusstringRequired
  One of queued, processing, ready, failed
- attemptsintegerRequired
- source_savedbooleanRequired
  Always true
- recall_readybooleanRequired
  True once the extracted memory can be recalled.
- resultobject or nullRequired
  2 fields in result
  - resource_idstring (uuid)Required
  - revisionintegerRequired
- error_codestring or nullRequired

Example response

{
  "items": [
    {
      "attempts": 0,
      "error_code": null,
      "id": "a322f538-22cc-4895-bc0b-08fb9302a97f",
      "recall_ready": false,
      "result": null,
      "source_saved": true,
      "status": "queued"
    }
  ]
}

Errors

401The API key is missing, unknown, expired or revoked. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl "https://<api-host>/v1/spaces/{space_id}/memory/jobs" \
  -H "Authorization: Bearer $SPACE_API_KEY"

POST `/v1/spaces/{space_id}/memory/jobs`

Start a memory extraction job

Queues extraction from text or a saved source. Poll the job until recall_ready.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

One of: RememberMemory
Write durable memory directly, without a source document or human review. Parameters: free text the agent wants to keep, optional topic labels and an optional originating resource revision. What it does: organizes, embeds and saves the supplied wording without generation. Long text is split losslessly into claims of at most 2,000 characters. On the explicit extraction-job endpoint, the same input is mined into generated claims. Output: the saved memory resource. Explicit links name existing memory nodes by ID, with relation related or expands_on; they need no Jev approval. Retries reuse command ID.
- command_idstring (uuid)Required
- titlestringRequired
  1 to 300 characters
- linksarray of object
  Up to 20 items
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstring
    One of related, expands_onDefault related
- textstringRequired
  1 to 12000 characters
- topicsarray of string
  Up to 12 itemsEach item: 1 to 100 charactersEach item: pattern ^[^|\r\n]+$
- memory_typestring
  One of chat, markdownDefault chat
- sourceobject or null
  2 fields in source
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- routes_toarray of string (uuid)
  Up to 8 items
- importanceinteger
  0 to 3Default 0
One of: BuildMemory
- command_idstring (uuid)Required
- sourceobjectRequired
  2 fields in source
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- resource_idstring (uuid) or null
- expected_revisioninteger
  At least 0Default 0

Responses

202Success

idstring (uuid)Required
statusstringRequired
One of queued, processing, ready, failed
attemptsintegerRequired
source_savedbooleanRequired
Always true
recall_readybooleanRequired
True once the extracted memory can be recalled.
resultobject or nullRequired
2 fields in result
- resource_idstring (uuid)Required
- revisionintegerRequired
error_codestring or nullRequired

Example response

{
  "attempts": 0,
  "error_code": null,
  "id": "a322f538-22cc-4895-bc0b-08fb9302a97f",
  "recall_ready": false,
  "result": null,
  "source_saved": true,
  "status": "queued"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/memory/jobs" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "command_id": "a322f538-22cc-4895-bc0b-08fb9302a97f",
    "text": "Atlas ships soon.",
    "title": "Atlas notes"
  }'

GET `/v1/spaces/{space_id}/memory/jobs/{job_id}`

Get a memory job

One memory job's progress and result.

Path parameters

space_idstring (uuid)Required
job_idstring (uuid)Required

Responses

200Success

idstring (uuid)Required
statusstringRequired
One of queued, processing, ready, failed
attemptsintegerRequired
source_savedbooleanRequired
Always true
recall_readybooleanRequired
True once the extracted memory can be recalled.
resultobject or nullRequired
2 fields in result
- resource_idstring (uuid)Required
- revisionintegerRequired
error_codestring or nullRequired

Example response

{
  "attempts": 0,
  "error_code": null,
  "id": "a322f538-22cc-4895-bc0b-08fb9302a97f",
  "recall_ready": false,
  "result": null,
  "source_saved": true,
  "status": "queued"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl "https://<api-host>/v1/spaces/{space_id}/memory/jobs/{job_id}" \
  -H "Authorization: Bearer $SPACE_API_KEY"

POST `/v1/spaces/{space_id}/memory/remember`

Remember authored text

Stores one authored memory exactly as written: organized, embedded and indexed without extraction. Recallable as soon as this returns.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

command_idstring (uuid)Required
titlestringRequired
1 to 300 characters
linksarray of object
Up to 20 items
2 fields in links
- resource_idstring (uuid)Required
- relationstring
  One of related, expands_onDefault related
textstringRequired
1 to 12000 characters
topicsarray of string
Up to 12 itemsEach item: 1 to 100 charactersEach item: pattern ^[^|\r\n]+$
memory_typestring
One of chat, markdownDefault chat
sourceobject or null
2 fields in source
- resource_idstring (uuid)Required
- revisionintegerRequired
  At least 1
routes_toarray of string (uuid)
Up to 8 items
importanceinteger
0 to 3Default 0

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
bodystringRequired
memoryobjectRequired
3 fields in memory
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
- versionintegerRequired
- linksarray of objectRequired
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstringRequired
    One of related, expands_on

Example response

{
  "author": "you",
  "author_agent": null,
  "author_client_id": null,
  "body": "## Atlas launch window\nAtlas launches in November.",
  "folder": null,
  "id": "3bd12481-05da-4243-9c3b-cc453fd74a31",
  "kind": "document",
  "memory": {
    "claims": [
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.876587+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": false,
        "id": "400f9a95-be1a-5386-bfbb-47ceb37ab434",
        "importance": 0,
        "index": "Atlas launch window",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Atlas launches in November."
      }
    ],
    "links": [
      {
        "relation": "expands_on",
        "resource_id": "c2557f17-be42-4b5d-a91f-50477fcf5de7"
      }
    ],
    "version": 2
  },
  "priority": null,
  "project": null,
  "recall": {
    "category": "memory",
    "excluded": false,
    "sources": [
      {
        "resource_id": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
        "revision": 2
      }
    ],
    "topics": []
  },
  "revision": 1,
  "status": "todo",
  "title": "Memory: Atlas launch window",
  "updated_at": "2026-10-08T01:56:07.904882+00:00"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/memory/remember" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "command_id": "75cc00c5-c5dd-469b-9c24-b66121080b45",
    "links": [
      {
        "relation": "expands_on",
        "resource_id": "c2557f17-be42-4b5d-a91f-50477fcf5de7"
      }
    ],
    "source": {
      "resource_id": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
      "revision": 2
    },
    "text": "Atlas launches in November.",
    "title": "Atlas launch window"
  }'

POST `/v1/spaces/{space_id}/memory/change`

Edit, classify or forget a claim

Edits, forgets, classifies or routes one claim. forget removes it from recall immediately and permanently.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

command_idstring (uuid)Required
resource_idstring (uuid)Required
expected_revisionintegerRequired
At least 1
entry_idstring (uuid)Required
actionstringRequired
One of edit, forget, classify, route
valuestring or null
1 to 2000 characters
classificationobject or null
4 fields in classification
- scopestring
  One of global, project, unassignedDefault unassigned
- category_idsarray of string (uuid)
  Up to 32 items
- project_idsarray of string (uuid)
  Up to 32 items
- section_idsarray of string (uuid)
  Up to 32 items
routes_toarray of string (uuid) or null
Up to 8 items

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
bodystringRequired
memoryobjectRequired
3 fields in memory
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
- versionintegerRequired
- linksarray of objectRequired
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstringRequired
    One of related, expands_on

Example response

{
  "author": "you",
  "author_agent": null,
  "author_client_id": null,
  "body": "## Launch month\nAtlas launches in early November.\n\n## Owner\nSam owns the Atlas launch.",
  "folder": null,
  "id": "c2557f17-be42-4b5d-a91f-50477fcf5de7",
  "kind": "document",
  "memory": {
    "claims": [
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.311000+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": true,
        "generated_value": "Atlas launches in November.",
        "id": "cec465b1-0330-5209-8518-9c4ee6b52841",
        "importance": 0,
        "index": "Launch month",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Atlas launches in early November."
      },
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.311000+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": false,
        "id": "36976ce0-886b-51af-822f-f3efd5d720d6",
        "importance": 1,
        "index": "Owner",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Sam owns the Atlas launch."
      }
    ],
    "links": [],
    "version": 2
  },
  "priority": null,
  "project": null,
  "recall": {
    "category": "memory",
    "excluded": false,
    "sources": [],
    "topics": []
  },
  "revision": 2,
  "status": "todo",
  "title": "Memory: Atlas launch facts",
  "updated_at": "2026-10-08T01:56:07.538071+00:00"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/memory/change" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "edit",
    "command_id": "ae2a674c-820e-451e-82f4-4f5f7831688a",
    "entry_id": "cec465b1-0330-5209-8518-9c4ee6b52841",
    "expected_revision": 1,
    "resource_id": "c2557f17-be42-4b5d-a91f-50477fcf5de7",
    "value": "Atlas launches in early November."
  }'

POST `/v1/spaces/{space_id}/memory/creator`

Correct claim attribution

Corrects who created selected claims: an agent identity, or null for you.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

command_idstring (uuid)Required
resource_idstring (uuid)Required
expected_revisionintegerRequired
At least 1
creator_agent_idstring (uuid) or null
entry_idsarray of string (uuid)Required
1 to 24 items

Responses

200Success

idstring (uuid)Required
kindstringRequired
One of document, task
revisionintegerRequired
Send this as expected_revision to change it.
At least 1
titlestringRequired
statusstringRequired
A task column value. Documents report todo.
updated_atstring (date-time)Required
authorstringRequired
"you", "agent", or a teammate's display name in a team Space.
author_client_idstring (uuid) or nullRequired
The agent connection that wrote this revision, if an agent did.
author_agentobject or nullRequired
5 fields in author_agent
- idstring (uuid)Required
- revisionintegerRequired
- namestringRequired
- harnessstringRequired
  The agent's software, such as claude, codex or cursor.
- {key}any
  Any other key.
projectstring (uuid) or nullRequired
folderstring (uuid) or nullRequired
prioritystring or nullRequired
One of High, Medium, Low
recallobjectRequired
4 fields in recall
- categorystringRequired
  source for documents and tasks, handoff for session handoffs, memory for memory records.
  One of source, handoff, memory
- topicsarray of stringRequired
- sourcesarray of objectRequired
  Exact source revisions this item cites.
  2 fields in sources
  - resource_idstring (uuid)Required
  - revisionintegerRequired
    At least 1
- excludedbooleanRequired
  True when the item is kept out of recall.
bodystringRequired
memoryobjectRequired
3 fields in memory
- claimsarray of objectRequired
  13 fields in claims
  - idstring (uuid)Required
    The claim's entry_id, used to edit or forget it.
  - indexstringRequired
    A short label for the claim.
  - valuestringRequired
    The claim's exact text.
  - memory_typestringRequired
    One of factual, procedural
  - importanceintegerRequired
    0 to 3
  - editedbooleanRequired
  - created_atstring (date-time)Required
  - classificationobjectRequired
    6 fields in classification
    scopestringRequired
    One of global, project, unassigned
    category_idsarray of string (uuid)Required
    project_idsarray of string (uuid)Required
    section_idsarray of string (uuid)Required
    methodstringRequired
    How the assignment was made, such as manual or typesafe.
    reasonstringRequired
  - creatorobjectRequired
    3 fields in creator
    kindstringRequired
    One of human, agent
    basisstringRequired
    How the creator is known, such as captured or assigned.
    agentobject or nullRequired
    5 fields in agent
    idstring (uuid)Required
    revisionintegerRequired
    namestringRequired
    harnessstringRequired
    The agent's software, such as claude, codex or cursor.
    {key}any
    Any other key.
  - relationshipsobject or null
    2 fields in relationships
    statusstringRequired
    linksarray of objectRequired
  - generated_valuestring or null
    The original wording, present once a claim was edited.
  - routes_toarray of string (uuid) or null
    Containers this claim governs, from the Space map.
  - sourcestring or null
    In memory listings: the cited source resource ID, or the author kind.
- versionintegerRequired
- linksarray of objectRequired
  2 fields in links
  - resource_idstring (uuid)Required
  - relationstringRequired
    One of related, expands_on

Example response

{
  "author": "you",
  "author_agent": null,
  "author_client_id": null,
  "body": "## Launch month\nAtlas launches in early November.\n\n## Owner\nSam owns the Atlas launch.",
  "folder": null,
  "id": "c2557f17-be42-4b5d-a91f-50477fcf5de7",
  "kind": "document",
  "memory": {
    "claims": [
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.311000+00:00",
        "creator": {
          "agent": null,
          "basis": "captured",
          "kind": "human"
        },
        "edited": true,
        "generated_value": "Atlas launches in November.",
        "id": "cec465b1-0330-5209-8518-9c4ee6b52841",
        "importance": 0,
        "index": "Launch month",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Atlas launches in early November."
      },
      {
        "classification": {
          "category_ids": [],
          "method": "unassigned",
          "project_ids": [],
          "reason": "uncertain",
          "scope": "unassigned",
          "section_ids": []
        },
        "created_at": "2026-10-08T01:56:07.311000+00:00",
        "creator": {
          "agent": null,
          "basis": "user_attributed",
          "kind": "human"
        },
        "edited": false,
        "id": "36976ce0-886b-51af-822f-f3efd5d720d6",
        "importance": 1,
        "index": "Owner",
        "memory_type": "factual",
        "relationships": {
          "links": [],
          "status": "disabled"
        },
        "value": "Sam owns the Atlas launch."
      }
    ],
    "links": [],
    "version": 2
  },
  "priority": null,
  "project": null,
  "recall": {
    "category": "memory",
    "excluded": false,
    "sources": [],
    "topics": []
  },
  "revision": 3,
  "status": "todo",
  "title": "Memory: Atlas launch facts",
  "updated_at": "2026-10-08T01:56:07.586955+00:00"
}

Errors

401The API key is missing, unknown, expired or revoked. Error
402An active subscription is required to add content. Reading, export and deletion still work. Error
403Not allowed: a read-only key, a view-only role, or an operation keys cannot do. Error
404Not found. Other Spaces also look absent to a key. Error
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
429A Space quota is exhausted (storage, items or monthly model requests). Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/memory/creator" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "command_id": "acb3d601-94e7-4fb9-987a-eb85b9a1b6d5",
    "creator_agent_id": null,
    "entry_ids": [
      "36976ce0-886b-51af-822f-f3efd5d720d6"
    ],
    "expected_revision": 2,
    "resource_id": "c2557f17-be42-4b5d-a91f-50477fcf5de7"
  }'

Articles Discover Space Memory questions

Memory

GET /v1/spaces/{space_id}/memories/{resource_id}

Path parameters

Responses

Example request

DELETE /v1/spaces/{space_id}/memories/{resource_id}

Path parameters

Query parameters

Responses

Example request

GET /v1/spaces/{space_id}/memory/provider

Path parameters

Responses

Example request

GET /v1/spaces/{space_id}/memories

Path parameters

Query parameters

Responses

Example request

GET /v1/spaces/{space_id}/memories/{resource_id}/links

Path parameters

Query parameters

Responses

Example request

PUT /v1/spaces/{space_id}/memories/{resource_id}/links

Path parameters

Request bodyRequired

Responses

Example request

POST /v1/spaces/{space_id}/memory/build

Path parameters

Request bodyRequired

Responses

Example request

POST /v1/spaces/{space_id}/memory/claims

Path parameters

Request bodyRequired

Responses

Example request

GET /v1/spaces/{space_id}/memory/jobs

Path parameters

Responses

Example request

POST /v1/spaces/{space_id}/memory/jobs

Path parameters

Request bodyRequired

Responses

Example request

GET /v1/spaces/{space_id}/memory/jobs/{job_id}

Path parameters

Responses

Example request

POST /v1/spaces/{space_id}/memory/remember

Path parameters

Request bodyRequired

Responses

Example request

POST /v1/spaces/{space_id}/memory/change

Path parameters

Request bodyRequired

Responses

Example request

POST /v1/spaces/{space_id}/memory/creator

Path parameters

Request bodyRequired

Responses

Example request

GET `/v1/spaces/{space_id}/memories/{resource_id}`

DELETE `/v1/spaces/{space_id}/memories/{resource_id}`

GET `/v1/spaces/{space_id}/memory/provider`

GET `/v1/spaces/{space_id}/memories`

GET `/v1/spaces/{space_id}/memories/{resource_id}/links`

PUT `/v1/spaces/{space_id}/memories/{resource_id}/links`

POST `/v1/spaces/{space_id}/memory/build`

POST `/v1/spaces/{space_id}/memory/claims`

GET `/v1/spaces/{space_id}/memory/jobs`

POST `/v1/spaces/{space_id}/memory/jobs`

GET `/v1/spaces/{space_id}/memory/jobs/{job_id}`

POST `/v1/spaces/{space_id}/memory/remember`

POST `/v1/spaces/{space_id}/memory/change`

POST `/v1/spaces/{space_id}/memory/creator`