Skip to main content
POST
/
workspaces
Create workspace
curl --request POST \
  --url https://www.orgo.ai/api/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my-workspace",
  "icon_url": "<string>",
  "status": "active"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-workspace",
  "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
  "status": "active",
  "icon_url": null,
  "created_at": "2026-04-07T10:30:00Z"
}
Creates a new workspace to organize your computers.
Workspaces are containers for computers. Use them to separate different projects, environments, or teams.

​
Request

​
name
string
required
Workspace name. Must be unique within your account.
​
icon_url
string
Optional URL of an icon for the workspace.
​
status
string
default:"active"
Workspace status: active or inactive.

​
Response

​
id
string
Unique workspace identifier.
​
name
string
Workspace name.
​
user_id
string
Owner user ID.
​
status
string
Workspace status.
​
icon_url
string
Icon URL, if set.
​
created_at
string
ISO 8601 timestamp.

​
Example

curl -X POST https://www.orgo.ai/api/workspaces \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production"}'

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "production",
  "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
  "status": "active",
  "icon_url": null,
  "created_at": "2026-04-07T10:30:00Z"
}

​
Errors

  • 400 - Name is empty, or a workspace with this name already exists

Authorizations

​
Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Body

application/json
​
name
string
required

Workspace name. Must be unique within your account.

Minimum string length: 1
Example:

"my-workspace"

​
icon_url
string

Optional icon URL

​
status
enum<string>
default:active
Available options:
active,
inactive

Response

Workspace created

​
id
string

Unique workspace identifier

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string

Workspace name

Example:

"production"

​
user_id
string

Owner user ID

​
status
enum<string>
Available options:
active,
inactive
Example:

"active"

​
icon_url
string | null

Optional icon URL

​
created_at
string<date-time>
​
updated_at
string<date-time>