v2

latestOpenAPI 3.1.02026-07-262937191.0 MB
beta.admin.workspaces

Create Workspace

Create a Workspace.

post/v1/admin/workspaces

Request body

namestring required

Workspace name.

descriptionstring

Workspace description.

iconstring

Workspace icon.

add_all_org_membersboolean

Whether to add all Organization members to the Workspace.

admin_user_idstring uuid required

User ID to grant the Workspace Admin role to.

Example request

{
  "name": "Product Team",
  "description": "Workspace for product and design teams",
  "icon": "★"
}

Response

OK

uuidstring uuid required

Workspace ID.

namestring required

Workspace name.

descriptionstring nullable required

Workspace description.

iconstring nullable required

Workspace icon.

members_countinteger nullable

Number of members in the Workspace.

is_defaultboolean required

Whether this is the default Workspace for the Organization.

Example response

{
  "name": "Product Team",
  "description": "Workspace for product and design teams",
  "icon": "★",
  "spend_limit": {
    "currency": "USD"
  }
}