Sign in

v1

latestOpenAPI 3.0.12026-08-064278250.7 KB
workspaces

Retrieve a workspace

Retrieve a workspace by its unique identifier.

get/v1/workspaces

Headers

Workspacestring required

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

Response

Success

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"
}