API Reference Workspaces

Create Workspace

POSThttps://api-v2.crosscheck.cloud/api/v1/workspaces

Create a workspace for the current user. Workspace and plan limits apply.

Authentication

Send a valid Crosscheck session JWT in the Authorization: Bearer YOUR_SESSION_TOKEN header. Workspace endpoints use the active workspace in your session. MCP OAuth tokens are not accepted here.

Body Parameters

application/json

namestringrequired

A non-empty name.

Headers

Accept

JSON request and response format.

application/json

Authorization

A valid session JWT from Crosscheck authentication.

Bearer YOUR_SESSION_TOKEN

Content-Type

JSON request and response format.

application/json

Responses

201 Created

`id`string · uuid	Unique workspace identifier.
`name`string	Workspace name.
`avatar`string \| null	Workspace avatar.
`plan`string	Workspace subscription plan.
`createdBy`string · uuid	Workspace creator.
`createdAt / updatedAt`string \| null	ISO 8601 timestamps.

400 Invalid request

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

401 Authentication required

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

403 Insufficient permissions

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

404 Resource not found

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

Selected fields and abbreviated examples are shown. Additional fields and error codes depend on the resource, permissions, plan and retention state.