> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dalyenergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Organization Workspace

> Create a new workspace under an organization

# POST /organizations/{organization_id}/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.

<Warning>
  The `api_key` in the response is shown only once. Make sure to copy and store it immediately.
</Warning>

* 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](/api-reference/endpoints/organizations-workspaces) to view all workspaces after creation.
