List spaces

GET /api/v1/community/spaces

Lists the spaces the key's holder can read, each one checked against the same community permission as in Cohorte. A member only sees the spaces of the programs and cohorts they are enrolled in.

Authorization

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Conditional — only the spaces of their own enrollments

Requirement	Rule for this endpoint
Business role	None
Resource scope	Spaces of the key's organization
Participation	For a `MEMBER`: an enrollment in the space's program or cohort
Resource state	Archived spaces are listed with `status: "archived"`

Request headers

Header	Required	Description
`x-api-key`	yes	API key created for this organization
`X-Correlation-Id`	no	Caller correlation id, returned or generated

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/community/spaces" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the readable spaces, possibly empty.
401 Unauthorized — missing, unknown or expired key.

Response fields

Field	Type	Description
`data[].id`	UUID	Space id
`data[].name`	string	Space name
`data[].scopeType`	string	`program` or `cohort`
`data[].scopeTargetId`	UUID	The program or cohort
`data[].status`	string	`open` or `archived`
`data[].position`	number	Display order
`data[].createdAt`	string	ISO 8601

Example response

json

{
  "success": true,
  "data": [
    {
      "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "name": "Agentic AI — Spring 2026",
      "scopeType": "cohort",
      "scopeTargetId": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
      "status": "open",
      "position": 0,
      "createdAt": "2026-03-01T08:00:00.000Z"
    }
  ],
  "correlationId": "c0ffee00-1111-4222-8333-444455556666"
}

Notes

API keys follow the community permissions only. The personal Community publishing setting of MCP permissions applies to MCP clients, not to API keys.

List spaces

List spaces

Authorization

Request headers

Example

Response

Response fields

Example response

Notes

Related

Authorization

Request headers

Example

Response

Response fields

Example response

Notes

Related