v1

latestOpenAPI 3.0.3MIT2026-07-24122271451.2 KB
User and Workspace management

Create Workspace

Create a workspace in your organization.

  • You need to be an Org Admin to create a workspace.
  • You will be added to the new workspace with an Admin role.
post/public/v1/workspaces

Request body

namestring required

A name for the new workspace.

icon_urlstring uri

Workspace icon will be displayed in the application and is not visible to your customers. Icon should have square proportions. Supported formats: JPEG, PNG, GIF, WEBP. Max size: 5 MB

Example request

{
  "name": "A new workspace",
  "icon_url": "https://cdn.example.com/icons/workspace.png"
}

Response

OK

idstring
namestring

Example response

{
  "id": "iMymdDd9XFD3HyxP5VD67Q",
  "name": "A new workspace"
}