Skip to main content
POST
Create workspace
Creates a new workspace to organize your computers.
Workspaces are containers for computers. Use them to separate different projects, environments, or teams.

Request

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

Response

string
Unique workspace identifier.
string
Workspace name.
string
Owner user ID.
string
Workspace status.
string
Icon URL, if set.
string
ISO 8601 timestamp.

Example

Response

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>