API reference

Workspaces

Workspaces hold the memory graph and the audit ledger. The API mirrors the admin console.

The workspace object

workspace

{
  "id":              "ws_01HZX...",
  "organization_id": "org_01HZX...",
  "name":            "Acme — Revenue Operations",
  "slug":            "acme-revops",
  "data_residency":  "us-east",
  "status":          "active",
  "created_at":      "2026-01-12T10:18:00Z"
}

POST /v1/workspaces

Create a new workspace.

Field	Type	Note
name	string	Display name. 2–100 characters.
slug	string	URL slug. lowercase, 3–48 chars.
data_residency	string	us-east, eu-west, ap-sydney.
inherit_sso	boolean	Default true.

curl

curl -X POST https://api.mnemos.ai/v1/workspaces \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme — Revenue Operations",
    "slug": "acme-revops",
    "data_residency": "us-east"
  }'

GET /v1/workspaces

List workspaces in the organization.

curl

curl https://api.mnemos.ai/v1/workspaces?limit=50 \
  -H "Authorization: Bearer $MNEMOS_API_KEY"

response

{
  "data": [ { "id": "ws_01H...", "name": "Acme", "slug": "acme" } ],
  "has_more": false,
  "next_cursor": null
}

GET /v1/workspaces/{id}

Retrieve a single workspace.

curl

curl https://api.mnemos.ai/v1/workspaces/ws_01HZX... \
  -H "Authorization: Bearer $MNEMOS_API_KEY"

PATCH /v1/workspaces/{id}

Update a workspace. name, slug, and inherit_sso are mutable. data_residency is immutable after creation.

curl

curl -X PATCH https://api.mnemos.ai/v1/workspaces/ws_01HZX... \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme — RevOps (renamed)" }'

POST /v1/workspaces/{id}/archive

Soft-delete a workspace. Initiates the 30-day retention window before cryptographic erasure.