Create Workspace

Create a new workspace in your organization.

Not a blank slate: the caller and every existing organization admin are auto-added as organization admins, so they'll immediately appear in the workspace's "All Users" group, whose membership always tracks the roster. Other org members aren't added until separately granted access.

post

/workspaces

Authorizations

AuthorizationstringRequired

A Personal Access Token (PAT).

Body

namestringRequired

provision_by_defaultbooleanOptional

When true, new users signing in via SSO are automatically granted access to this workspace; when false, they need an explicit invite.

Default: false

Responses

201

Successful Response

application/json

4XX

Client Error

application/json

5XX

Server Error

application/json

post/workspaces

curl -L -X POST https://api-external.zenlytic.com/api/v2/workspaces \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name": "acme-staging", "provision_by_default": false}'

{
  "data": {
    "id": "ws_789",
    "name": "acme-staging",
    "provision_by_default": false
  },
  "meta": {
    "status": "success",
    "errors": [],
    "warnings": []
  }
}