Skip to Content
veriom

Create workspace

POST
/v1/workspaces

Authorization

workspaceToken
headerAuthorizationBearer <vat_<opaque-token>>

Expiring, hashed workspace token with explicit scopes.

Request Body

application/json
  1. body
billing_workspace_id?|

Add the workspace to this workspace's plan instead of starting a free trial. It then shares that plan's repositories and processing. Needs Owner or Admin in that workspace, a paid plan in good standing, and room in the plan's workspace count (limits.workspaces); otherwise 402 plan_limit_reached with resource workspaces, or 409 workspace_not_coverable when that workspace is itself covered.

name?|

Omit to use GET /v1/workspaces/name-suggestion. Without a name or a suggestion the API answers 422 with code workspace_name_required.

slug?|null

Response Body

Successful Response

application/json
  1. response
billing_workspace_id?|

The workspace whose plan the new one shares, if any.

id*Id
Formatuuid
name*Name
slug*Slug
Example Request
curl -X POST 'https://api.veriom.ai/v1/workspaces' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "billing_workspace_id": "19a63606-6efb-45b2-b603-bf7dc44e4eaf",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "slug": "string"}