Create a new workspace within an organization. Requires organization membership and workspace creation permissions.
curl --request POST \
--url https://{deploymentHost}/workspaces \
--header 'Content-Type: application/json' \
--data '{
"name": "<string>",
"description": "<string>",
"organization_id": "<string>"
}'
{
"status": 201,
"message": "",
"data": {
"workspace": {
"id": "workspace_123456789",
"name": "Development Team",
"description": "Workspace for the development team",
"organization": {
"id": "org_456789123",
"name": "Acme Corporation",
"slug": "acme-corp"
},
"members_count": 1,
"created_at": "2024-01-15T19:30:00Z",
"updated_at": "2024-01-15T19:30:00Z"
}
},
"session": {
"signin_attempts": [],
"signins": [
{
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
],
"signup_attempts": [],
"active_signin": {
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
},
"errors": []
}
Session cookie authentication for production deployments. The session token is automatically set as an HTTP-only, secure cookie.
Workspace created successfully
The response is of type object
.
curl --request POST \
--url https://{deploymentHost}/workspaces \
--header 'Content-Type: application/json' \
--data '{
"name": "<string>",
"description": "<string>",
"organization_id": "<string>"
}'
{
"status": 201,
"message": "",
"data": {
"workspace": {
"id": "workspace_123456789",
"name": "Development Team",
"description": "Workspace for the development team",
"organization": {
"id": "org_456789123",
"name": "Acme Corporation",
"slug": "acme-corp"
},
"members_count": 1,
"created_at": "2024-01-15T19:30:00Z",
"updated_at": "2024-01-15T19:30:00Z"
}
},
"session": {
"signin_attempts": [],
"signins": [
{
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
],
"signup_attempts": [],
"active_signin": {
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
},
"errors": []
}