API reference / Space guide

Export

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.

Paged export of everything in the Space.

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.

POST `/v1/spaces/{space_id}/export`

Export one page of the Space

Exports everything in the Space, including history, one page at a time. Send the first page's snapshot with after on the next pages; a 409 means the Space changed, so start again.

Path parameters

space_idstring (uuid)Required

Request bodyRequired

afterstring or null
Up to 100 characters
snapshotinteger or null
At least 0

Responses

200Success

formatstringRequired
source_spacestring (uuid)Required
snapshotintegerRequired
exported_atstring (date-time)Required
task_columnsarray of object or null
First page only.
2 fields in task_columns
- valuestringRequired
  The status value stored on tasks, such as in_progress.
- labelstringRequired
entriesarray of objectRequired
3 fields in entries
- entitystringRequired
  What value holds, such as resource or item.
- currentbooleanRequired
  False for an earlier revision kept as history.
- valueobjectRequired
next_cursorstring or nullRequired

Example response

{
  "entries": [
    {
      "current": false,
      "entity": "resource",
      "value": {
        "author": "you",
        "author_agent": null,
        "author_client_id": null,
        "body": "Summarize what changed.",
        "folder": null,
        "id": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
        "kind": "task",
        "priority": "High",
        "project": null,
        "recall": {
          "category": "source",
          "excluded": false,
          "sources": [],
          "topics": []
        },
        "revision": 1,
        "status": "todo",
        "title": "Write the Atlas changelog",
        "updated_at": "2026-10-08T01:56:07.009263+00:00"
      }
    },
    {
      "current": true,
      "entity": "resource",
      "value": {
        "author": "you",
        "author_agent": null,
        "author_client_id": null,
        "body": "Summarize what changed.",
        "folder": null,
        "id": "e9ddabe5-f2a7-477f-819d-8dfabafaabdf",
        "kind": "task",
        "priority": "High",
        "project": null,
        "recall": {
          "category": "source",
          "excluded": false,
          "sources": [],
          "topics": []
        },
        "revision": 2,
        "status": "review",
        "title": "Write the Atlas changelog",
        "updated_at": "2026-10-08T01:56:07.070776+00:00"
      }
    }
  ],
  "exported_at": "2026-10-08T01:56:07.174881+00:00",
  "format": "space.archive.v1",
  "next_cursor": null,
  "snapshot": 5,
  "source_space": "704ffc7a-8ef2-4be4-931d-35f4d4f21933"
}

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
409Conflict: a stale expected_revision, a reused command_id, or a changed snapshot. Re-read and retry. Error
422Invalid fields, revision or payload. Error
503Temporarily unavailable or busy. Retry with backoff, honouring Retry-After. Error

Example request

curl -X POST "https://<api-host>/v1/spaces/{space_id}/export" \
  -H "Authorization: Bearer $SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "after": "r:d014e80a-06d2-4cc8-864e-15f1929ca81b:0000000001",
    "snapshot": 5
  }'