Skip to main content
POST
/
organizations
/
{organization_id}
/
workspaces
Create Organization Workspace
curl --request POST \
  --url https://api.example.com/organizations/{organization_id}/workspaces

​
POST /organizations//workspaces

Provisions a new workspace within the organization. The workspace is initialized with default settings, an API key, and appropriate membership records.

​
Notes

  • Requires owner or admin role. Members and viewers cannot create workspaces.
  • The identifier field is required and serves as the human-readable workspace name.
  • On success, the response includes the new workspace_id, identifier, organization_id, and a one-time api_key. Store the API key securely — it cannot be retrieved again.
The api_key in the response is shown only once. Make sure to copy and store it immediately.
  • The calling user is automatically assigned owner role on the new workspace.
  • All existing organization owners are granted admin-level access to the new workspace.
  • Default workspace settings (modeling defaults, preferences) are applied automatically.
  • See List Organization Workspaces to view all workspaces after creation.