Workspace

Get workspace

Reads the connected workspace's identity (name, slug) and echoes back which scopes the calling API key has. Intended as a first call to confirm the key is pointed at the right org.

GET/api/public/workspace

cURLGET /api/public/workspace

curl "https://postiv.ai/api/public/workspace" \
  -H "Authorization: Bearer pk_postiv_..."

200Response

{
  "success": true,
  "workspace": {
    "id": "9e6397ad-0000-0000-0000-000000000000",
    "name": "Postiv AI",
    "slug": "postiv-ai",
    "createdAt": "2026-01-04T10:00:00.000Z",
    "scopes": [
      "workspace:read",
      "posts:read",
      "posts:write"
    ]
  }
}

Authorization

Requires an organization API key with the workspace:read scope, sent as Authorization: Bearer or x-api-key.

Response

The organization plus the caller's own scope list.

workspace.iduuid

Organization id.

workspace.namestring

Organization display name.

workspace.slugstring

Organization slug.

workspace.createdAttimestamp

Org creation time.

workspace.scopesstring[]

Scopes granted to this API key.

Errors

404	workspace_not_found: the key's org_id no longer resolves to an organizations row

Good to know

Also exposed as the MCP tool get_workspace, recommended as the very first call in a session.