Skip to main content
POST
Create Workspace

Create Workspace

Creates a new workspace for the authenticated user.
Write access policy - This endpoint requires the write:tokens scope and API write access on the token owner account. Workspace creation is blocked when the owner is at/above their workspace plan limit (existing workspaces stay accessible).

Endpoint

Authentication

Requires a valid API token in the Authorization header.

Request

Headers

Body Parameters

Request Body

Response

Success Response

Status: 201 Created

Examples

Error Responses

400 Bad Request

Causes:
  • Missing or empty name field
  • name exceeds 255 characters
  • Invalid field types

401 Unauthorized

403 Forbidden

Causes:
  • Owner plan does not include API write access
  • Owner reached workspace creation limit on current plan

500 Internal Server Error

Validation Rules

  • name: Required, non-empty string, max 255 characters
  • description: Optional string

Next Steps

Update Workspace

Update workspace details

Create Tokenset

Add tokensets to your workspace