GET · Bearer

GET /api/v1/workspaces/:id

All endpoints · Markdown

Summary

One sub-account. Returns id, name, inbox_quota, inboxes_used, account_id, api_key_prefix, and created_at. The API key secret is not returned. Another parent's workspace returns 404 workspace_not_found. A sub-account key returns 403 permission_denied. An inbox-scoped key returns 403 permission_denied. MCP: cooper_get_workspace.

Request

This call has no JSON body.

Response

HTTP 200. Sample values illustrate the schema.

{
  "object": "workspace",
  "id": "inb_example",
  "name": "string",
  "inbox_quota": 1,
  "inboxes_used": 1,
  "account_id": "acc_example",
  "api_key_prefix": "string",
  "created_at": "2026-10-18T12:00:00.000Z"
}

Errors

  • HTTP 404 workspace_not_found
  • HTTP 403 permission_denied

Idempotency

This route does not document Idempotency-Key or client_id.