Get All Spaces

GET 
/projects/spaces

Returns the location workspace (id, name) and every space the token can access. Marketplace example: bootstrap a Projects UI by listing spaces, then create a folder/list under one space.

Request

Version stringrequired

API Version

Available optionsv3

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Workspace and spaces returned

application/json

Schema

Schema

workspaceobjectrequired

Location workspace

spacesobject[]required

Accessible spaces under the workspace

Example (auto)

{
  "workspace": {
    "id": "6a102435124ecfb348bd5505",
    "name": "Workspace"
  },
  "spaces": [
    {
      "id": "6a102435124ecfb348bd5506",
      "type": "space",
      "name": "Marketing",
      "locationId": "ve9EPM428h8b87FE9C12Kg",
      "color": "#3B82F6",
      "isPrivate": false,
      "position": "a0",
      "createdAt": "2026-09-20T10:00:00.000Z",
      "updatedAt": "2026-09-21T12:00:00.000Z"
    }
  ]
}