Workspaces
Create a workspace
POST
https://backend.immut.io/api/v1/workspacesRequired scope: workspaces:write
Most organisations use the one they already have; list them with GET /workspaces first rather than creating a second.
Request body
Content type: application/json (required)
| Field | Type | Required | Description |
|---|---|---|---|
name | string | yes | workspace name (required) |
Responses
| Status | Meaning |
|---|---|
200 | Success |
400 | BadRequest |
401 | Unauthorized |
403 | Forbidden |
429 | RateLimited |
Example
curl -X POST "https://backend.immut.io/api/v1/workspaces" \
-H "Authorization: Bearer $IMMUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"<name>"}'
Generated from the immut API contract, version 1.9.0. Machine-readable: this page as markdown · everything in one file · OpenAPI