Create Workspace

Create a new workspace under the API key holder's organization. Only **personal** API keys can create workspaces — workspace-scoped keys are intentionally limited to their existing workspace. A default agent workflow is created unless `skipDefaultWorkflow=true`.

POST/api/v1/workspaces

Authorization

apiKey
X-API-Key<token>

Your SteelEngine API key (personal or workspace). Generate one from the SteelEngine dashboard under Settings > API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/workspaces" \  -H "Content-Type: application/json" \  -d '{    "name": "Engineering",    "color": "#3972F6",    "skipDefaultWorkflow": false  }'
{  "success": true,  "data": {    "workspace": {      "id": "string",      "name": "string",      "slug": "string",      "color": "string",      "ownerId": "string",      "organizationId": "string",      "billedAccountUserId": "string",      "allowPersonalApiKeys": true,      "role": "admin",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "archivedAt": "2019-08-24T14:15:22Z"    }  }}