v1

latestOpenAPI 3.0.12026-08-064278250.7 KB

workspaces

Create a workspace

Create a new workspace. Each workspace represents a separate organization. Managed service providers (MSPs) can create child workspaces for each of their customers.

post/v1/workspaces

Headers

Workspacestring required

The workspace identifier, which isolates API requests inside the provided workspace scope.

Request body

companyNamestring required

The name of the company for which the workspace is created.

displayNamestring required

The name displayed for the workspace from the user interface.

type'regular' | 'channel' | 'child' required

The type of workspace to be created. Types include: regular, for individual companies, channel for the MSP parent level, and child for MSP customers.

domainstring required

The workspace domain.

adminEmailstring required

The email address of the admin portal user who manages the workspace.

maxProtectedUsersinteger

The maximum number of protected users allowed in the workspace.

overCapacityAllowancenumber

The percentage by which Coro can exceed the maximum allowed users (e.g., 10 = 10%).

maxDevicesLimitinteger

The maximum number of protected devices allowed in the workspace.

notificationsLevel'none' | 'parent' | 'localAdmins' | 'all' required

The workspace admin portal users who receive notifications.

invitedByAdminNamestring

The full name of the administrator who sent the invitation.

invitedByAdminEmailstring

The email address of the administrator who sent the invitation.

Example request

{
  "companyName": "Company Name",
  "displayName": "Child workspace",
  "type": "child",
  "domain": "child-workspace.com",
  "adminEmail": "admin@child-workspace.com",
  "maxProtectedUsers": 25,
  "overCapacityAllowance": 10,
  "maxDevicesLimit": 25,
  "notificationsLevel": "all",
  "invitedByAdminName": "Martin Miller",
  "invitedByAdminEmail": "corotest@corotest.com"
}

Response

Created

idstring required

The unique identifier of the workspace.

companyNamestring required

The name of the company.

displayNamestring required

The name displayed for the workspace from the user interface.

type'regular' | 'channel' | 'child' required

The type of workspace.

domainstring required

The workspace domain.

maxProtectedUsersinteger

The maximum number of protected users allowed in the workspace.

overCapacityAllowancenumber

The fraction by which Coro can exceed the maximum allowed users (e.g. 0.10 = 10%).

maxDevicesLimitinteger

The maximum number of protected devices allowed in the workspace.

limitedboolean

Whether this workspace enforces user and device limits.

notificationsLevel'none' | 'parent' | 'localAdmins' | 'all'

The workspace admin portal users who receive notifications.

parentWorkspaceIdstring

The unique identifier of the parent/channel workspace.

protectedDevicesinteger

The number of protected devices in the workspace.

childrenstring[]

A list of any child workspaces provisioned for this workspace.

mainAdminEmailstring

The admin portal user email address provided when the workspace was created.

adminEmailsstring[]

The email addresses of all admin portal users associated with the workspace.

pendingAdminEmailsstring[]

The email addresses of all pending admins associated with the workspace.

lastAdminLoginTimeinteger

The most recent login to the workspace by an admin user, in UNIX format, including milliseconds.

workspaceCreationTimeinteger

The date the workspace was created, in UNIX format, including milliseconds.

workspaceCreationType'msp' | 'internal' | 'api' | 'direct' | 'distributorPortal'

Defines the method and creator of the workspace.<br>

msp – Workspace created via the MSP portal by a user with the MSP role.<br>
internal – Workspace created via the MSP portal by a user with the Global role.<br>
api – Workspace provisioned through the API.<br>
direct – Workspace created via the self-service sign-up process.

Example response

{
  "id": "corodevonmicrosoftcom_EZ90_b",
  "companyName": "Company Name",
  "displayName": "Child workspace",
  "type": "child",
  "domain": "child-workspace.com",
  "maxProtectedUsers": 25,
  "overCapacityAllowance": 0.1,
  "maxDevicesLimit": 25,
  "limited": true,
  "notificationsLevel": "none",
  "parentWorkspaceId": "coroparent_123",
  "lastAdminLoginTime": 1693562400000,
  "workspaceCreationTime": 1641009600000,
  "workspaceCreationType": "direct"
}