Menu
GET spaces/ User APIService tier

List spaces accessible to a user. Called by Matter list_spaces tool.

This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/spaces/
  • Service tierhttps://productivity.mattering.io/api/internal/spaces/

Responses

200 bare JSON object (no envelope)

{
  "spaces": [
    {
      "id": "...",
      "name": "...",
      "role": "...",
      "project_count": 0,
      "task_count": 0,
      "project_names": [
        "..."
      ]
    }
  ]
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400missing user_id message
401missing_actor
401unauthorized
403forbidden

Example

curl -X GET "https://productivity.mattering.io/api/user/v1/spaces/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: MatteringPMCore/internal_api.py (internal_api.internal_list_spaces)

GET spaces/{space_id}/members/ User APIService tier

List workspace members.

This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/spaces/{space_id}/members/
  • Service tierhttps://productivity.mattering.io/api/internal/spaces/{space_id}/members/

Path parameters

NameType
space_idstr

Responses

200 bare JSON object (no envelope)

{
  "members": [
    {
      "id": "...",
      "username": "...",
      "full_name": "...",
      "email": "...",
      "role": "..."
    }
  ]
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
401missing_actor
401unauthorized
403forbidden
404space_not_found

Example

curl -X GET "https://productivity.mattering.io/api/user/v1/spaces/SPACE_ID/members/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: MatteringPMCore/internal_api.py (internal_api.internal_space_members)

GET spaces/{space_id}/overview/ User APIService tier

Get workspace structure: folders, projects, stats.

Query keys: include_projects=0 returns the folders and stats only (projects is []), for callers that just need the tree.

This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/spaces/{space_id}/overview/
  • Service tierhttps://productivity.mattering.io/api/internal/spaces/{space_id}/overview/

Path parameters

NameType
space_idstr

Responses

200 bare JSON object (no envelope)

{
  "space": {
    "id": "...",
    "name": "..."
  },
  "stats": {
    "total_projects": 0,
    "total_tasks": "...",
    "member_count": 0
  },
  "folders": [
    {
      "id": "...",
      "name": "...",
      "project_count": 0
    }
  ],
  "projects": [
    {
      "id": "...",
      "name": "...",
      "status": "...",
      "folder_id": "...",
      "owner": "...",
      "task_count": 0
    }
  ]
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
401missing_actor
401unauthorized
403forbidden
404space_not_found

Example

curl -X GET "https://productivity.mattering.io/api/user/v1/spaces/SPACE_ID/overview/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: MatteringPMCore/internal_api.py (internal_api.internal_space_overview)

GET spaces/{space_id}/projects/ User APIService tier

List projects in a space with optional filters.

Query keys: folder_id, status, owner_username, q (name contains, case-insensitive), limit (default and cap 200) / offset, fields (comma-separated row keys to keep; id always stays) and full=1 to return whole descriptions (default clips them to 200 chars). The response carries meta (total, limit, offset, returned, has_more) beside projects.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/spaces/{space_id}/projects/
  • Service tierhttps://productivity.mattering.io/api/internal/spaces/{space_id}/projects/

Path parameters

NameType
space_idstr

Query parameters

NameDefault
fieldsnone
folder_idnone
fullnone
owner_usernamenone
qnone
statusnone

Pagination

Accepts limit and offset; the default page is 200 and the server caps limit at 200. The response meta carries total, limit and offset.

Responses

200 bare JSON object (no envelope)

{
  "projects": [
    "..."
  ],
  "meta": "..."
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
401missing_actor
401unauthorized
403forbidden
404space_not_found

Example

curl -X GET "https://productivity.mattering.io/api/user/v1/spaces/SPACE_ID/projects/?fields=...&folder_id=...&full=..." \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: MatteringPMCore/internal_api.py (internal_api.internal_space_projects)

All Productivity resources
Start Free Explore our Products