Skip to main content

Workspaces

Workspace-scoped resources use the path /v1/workspaces/:workspaceId/.... To resolve the current workspace (e.g. after login), use the endpoint below. All other workspace data is under the resource-specific endpoints (tickets, mailboxes, etc.).

GET /v1/workspaces/current​

Returns the workspace corresponding to the given x-workspace-id and the authenticated user/token. Use this to validate the workspace and get its name.

Auth: Required. Authorization: Bearer <token>, x-workspace-id: <workspaceId>.

Response (200):

{
  "id": "ws-123",
  "name": "My Workspace"
}

Example:

curl -X GET https://api.inboxops.app/v1/workspaces/current \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: ws-123"

Notes:

  • The workspace ID in the path for other endpoints (e.g. .../workspaces/ws-123/tickets) must match the workspace this token is allowed to use. The API enforces that the path workspaceId equals the token’s workspace.