Create a new space

Server URLloading...

POST

/v1/spaces

Send

Authorization

Header

Body

This endpoint allows you to create a new space within a tenant.

Scoped Requests (External Systems): When using a scoped API key, the endpoint automatically handles tenant and user provisioning:

• If the tenant doesn't exist, it will be created automatically
• If the user doesn't exist, it will be created and assigned to the tenant

Non-Scoped Requests: When using a non-scoped API key:

• Both the tenant and user must already exist in the system
• Returns 404 if either the tenant or user is not found

Header Parameters

The space data to create

Response Body

curl -X POST "https://example.com/v1/spaces" \  -H "x-user-id: string" \  -H "x-tenant-id: string" \  -H "Content-Type: application/json" \  -d '{    "name": "Product Development",    "description": "Space for tracking product development activities",    "type": "PROJECT",    "visibility": "PRIVATE"  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Product Development",
  "description": "Space for tracking product development activities",
  "type": "PROJECT",
  "visibility": "PRIVATE",
  "createdAt": "2025-12-30T10:30:00.000Z",
  "updatedAt": "2025-12-30T10:30:00.000Z"
}

{
  "message": "string"
}

{
  "message": "Invalid API Key"
}

{
  "message": "Tenant with id tenant-123 does not exist"
}

{
  "message": "Internal Server Error"
}