Menu

Workspace data

1 endpoint in the Mattering Productivity API.

GET workspace-data/{space_id}/ User APIService tier

Return workspace metadata (projects, widgets, members, statuses, batches, etc.) for the given space. Mirrors the output of automation_workspace_data but without requiring a logged-in Django user session.

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/workspace-data/{space_id}/
  • Service tierhttps://productivity.mattering.io/api/internal/workspace-data/{space_id}/

Path parameters

NameType
space_idstr

Responses

200 bare JSON object (no envelope)

{
  "success": true,
  "folders": [
    {
      "id": "...",
      "public_id": "...",
      "name": "..."
    }
  ],
  "projects": [
    {
      "id": "...",
      "public_id": "...",
      "name": "...",
      "folder_id": "...",
      "folder_public_id": "...",
      "folder_name": "...",
      "tabs": [
        {
          "id": "...",
          "public_id": "...",
          "name": "...",
          "widgets": [
            "..."
          ]
        }
      ]
    }
  ],
  "workspace_custom_fields": [
    {
      "id": "...",
      "public_id": "...",
      "name": "...",
      "field_type": "...",
      "options": [
        "..."
      ]
    }
  ],
  "status_presets": [
    {
      "id": "...",
      "name": "...",
      "statuses": [
        {
          "id": "...",
          "name": "...",
          "color": "...",
          "order": 0
        }
      ]
    }
  ],
  "members": [
    {
      "id": "...",
      "username": "...",
      "first_name": "...",
      "last_name": "...",
      "email": "..."
    }
  ],
  "batches": [
    {
      "id": "...",
      "name": "...",
      "custom_fields": {
        "...": "..."
      },
      "widget_id": "...",
      "widget_title": "...",
      "project_name": "..."
    }
  ],
  "batch_field_names": "...",
  "tasks": [
    {
      "id": "...",
      "title": "..."
    }
  ]
}

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/workspace-data/SPACE_ID/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

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

All Productivity resources
Start Free Explore our Products