Account

Create a workspace under the authenticated identity

post

Create a new workspace and attach the authenticated caller as the owner.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Body

application/json

Request body for POST /v1/me/workspaces.

region is intentionally not exposed here — the workspace is created in the region of the platform-api pod that handles the request (each region's CD pipeline serves its own ingress host), and a workspace cannot migrate between regions. The handler derives it from app.env.aws_region.

environment has no default: it is a load-bearing routing field (staging vs production downstream), and PATCH .../convert_environment is the supported migration path. Callers must commit to a value.

slugstring · min: 2 · max: 63RequiredPattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$

namestring · min: 1Required

environmentstring · enumRequiredPossible values:

backend_org_idany ofOptional

string · min: 1Optional

or

nullOptional

Responses

201

Successful Response

application/json

403

Insufficient permissions or unsupported principal type.

409

Workspace slug already taken.

422

Invalid request body.

503

Identity service unavailable.

post

/v1/me/workspaces

HTTPcURLJavaScriptPython

POST /v1/me/workspaces HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "slug": "text",
  "name": "text",
  "environment": "production",
  "backend_org_id": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "slug": "text",
  "name": "text",
  "environment": "text",
  "backend_org_id": "text",
  "region": "text",
  "connector_type": "text",
  "provisioned_at": "2026-05-12T12:06:27.611Z",
  "created_at": "2026-05-12T12:06:27.611Z",
  "updated_at": "2026-05-12T12:06:27.611Z"
}