Documentation

GET

api

spaces

List Spaces

curl --request GET \
  --url https://api.example.com/api/v1/spaces \
  --header 'Authorization: Bearer <token>'

{
  "spaces": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "meta": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}

Authorizations

Authorization

string

header

required

JWT access token or API key (csk_…)

Query Parameters

name

string | null

Exact-match filter on space name within the active org. Returns 0 or 1 spaces (names are unique per org).

Response

Successful Response

spaces

SpaceResponse · object[]

required

Show child attributes

total

integer

required

Create SpaceCreate a new memory space within the caller's active organization.

List Spaces

curl --request GET \
  --url https://api.example.com/api/v1/spaces \
  --header 'Authorization: Bearer <token>'

{
  "spaces": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "meta": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}