Organizations
Daytona provides organizations as a way to group resources and enable collaboration. Users can work individually in their personal organization or together in a collaborative organization.
Go to Daytona Dashboard ↗ to manage your organizations, or use the API to manage them programmatically.
Personal vs Collaborative
Section titled “Personal vs Collaborative”Every Daytona user starts with a personal organization, ideal for solo use and experimentation. Collaborative organizations are created manually and designed for company-wide collaboration with shared access and controls.
| Feature | Personal organization | Collaborative organization |
|---|---|---|
| Creation | Automatic on signup | Manually by a user |
| Members | Single user only | Multiple users (invite-based) |
| Access Control | No roles or permissions | Roles with granular resource-based assignments |
| Billing | Tied to individual user | Shared across team members |
| Use Case | Personal testing, small projects | Company/team development and production |
| Quota Scope | Per user | Shared across all members |
| Deletable | No | Yes (by Owner) |
Users can switch between their personal and collaborative organizations by using the dropdown in the Daytona Dashboard ↗ sidebar. Each organization has its own sandboxes, API keys, and resource quotas.
Create organization
Section titled “Create organization”Daytona provides options to create organizations in Daytona Dashboard ↗ or programmatically using the API.
- Go to Daytona Dashboard ↗
- Expand the dropdown at the top-left corner of the sidebar to view your organizations
- Click the Create Organization button
- Enter the organization name
- Select a region
- Click Create
curl 'https://app.daytona.io/api/organizations' \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "name": "My Organization", "defaultRegionId": "us"}'List organizations
Section titled “List organizations”List all organizations the authenticated user belongs to.
curl 'https://app.daytona.io/api/organizations' \ --header 'Authorization: Bearer YOUR_API_KEY'Get by ID
Section titled “Get by ID”Get an organization by ID.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID' \ --header 'Authorization: Bearer YOUR_API_KEY'Leave organization
Section titled “Leave organization”Leave an organization.
- Go to Daytona Dashboard ↗
- Expand the dropdown at the top-left corner of the sidebar to view your organizations
- Select the organization you want to leave
- Click Settings in the sidebar
- Click Leave Organization
- Confirm by clicking the Leave button
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/leave' \ --request POST \ --header 'Authorization: Bearer YOUR_API_KEY'Delete organization
Section titled “Delete organization”Delete an organization.
- Go to Daytona Dashboard ↗
- Expand the dropdown at the top-left corner of the sidebar to view your organizations
- Select the organization you want to delete
- Click Settings in the sidebar
- Click Delete Organization
- Confirm the deletion by typing the organization name and clicking the Delete button
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID' \ --request DELETE \ --header 'Authorization: Bearer YOUR_API_KEY'Users within an organization can have one of two different roles:
- Owners have full administrative access to the organization and its resources. Organization owners can perform administrative actions.
- Members have no administrative access to the organization, while their access to organization resources is based on Assignments.
Role assignments
Section titled “Role assignments”The list of available role assignments includes:
| Assignment | Description |
|---|---|
Viewer (required) | Grants read access to all resources in the organization |
Developer | Grants the ability to create sandboxes and keys in the organization |
Sandboxes Admin | Grants admin access to sandboxes in the organization |
Snapshots Admin | Grants admin access to snapshots in the organization |
Registries Admin | Grants admin access to registries in the organization |
Volumes Admin | Grants admin access to volumes in the organization |
Super Admin | Grants full access to all resources in the organization |
Auditor | Grants access to audit logs in the organization |
Infrastructure Admin | Grants admin access to infrastructure in the organization |
Create role
Section titled “Create role”Create a new role in an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/roles' \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "name": "Maintainer", "description": "Can manage all resources", "permissions": ["write:sandboxes", "delete:sandboxes"]}'List roles
Section titled “List roles”List all roles in an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/roles' \ --header 'Authorization: Bearer YOUR_API_KEY'Update role
Section titled “Update role”Update a role in an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/roles/ROLE_ID' \ --request PUT \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "name": "Maintainer", "description": "Can manage all resources", "permissions": ["write:sandboxes", "delete:sandboxes"]}'Delete role
Section titled “Delete role”Delete a role in an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/roles/ROLE_ID' \ --request DELETE \ --header 'Authorization: Bearer YOUR_API_KEY'Members
Section titled “Members”Daytona provides methods to manage members in an organization.
List members
Section titled “List members”List all members in an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/users' \ --header 'Authorization: Bearer YOUR_API_KEY'Invite members
Section titled “Invite members”Invite a new user to an organization.
- Go to Daytona Dashboard ↗
- Click the Invite Member button
- Enter the email address of the user you want to invite
- Select a role for the new user. If you select the
Memberrole, define their assignments
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/invitations' \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "email": "mail@example.com", "role": "member", "assignedRoleIds": ["00000000-0000-0000-0000-000000000001"]}'Remove members
Section titled “Remove members”Remove a user from an organization.
- Go to Daytona Dashboard ↗
- Click the Remove button next to the user you want to remove
- Confirm the removal by clicking the Remove button
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/users/USER_ID' \ --request DELETE \ --header 'Authorization: Bearer YOUR_API_KEY'Update access
Section titled “Update access”Update the access of a member in an organization.
- Go to Daytona Dashboard ↗
- Click the three-dot menu on the member row
- Click Change Role or Manage Assignments
- Update the role or assignments and click Save
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/users/USER_ID/access' \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "role": "member", "assignedRoleIds": ["00000000-0000-0000-0000-000000000001"]}'Invitations
Section titled “Invitations”Manage invitations in an organization.
- Go to Daytona Dashboard ↗
- Expand the dropdown at the bottom of the sidebar to view pending invitations to join other organizations.
curl 'https://app.daytona.io/api/organizations/invitations' \ --header 'Authorization: Bearer YOUR_API_KEY'Get invitations count
Section titled “Get invitations count”Get the number of invitations in an organization.
curl 'https://app.daytona.io/api/organizations/invitations/count' \ --header 'Authorization: Bearer YOUR_API_KEY'Accept invitation
Section titled “Accept invitation”Accept a pending organization invitation.
- Go to Daytona Dashboard ↗
- Click your profile at the bottom-left of the sidebar
- Click Invitations
- Click the checkmark button on the invitation row
curl 'https://app.daytona.io/api/organizations/invitations/INVITATION_ID/accept' \ --request POST \ --header 'Authorization: Bearer YOUR_API_KEY'Once a user accepts an invitation to join an organization, they get access to resource quotas assigned to that organization and they may proceed by issuing a new API key and creating sandboxes.
Decline invitation
Section titled “Decline invitation”Decline a pending organization invitation.
- Go to Daytona Dashboard ↗
- Click your profile at the bottom-left of the sidebar
- Click Invitations
- Click the X button on the invitation row
- Confirm by clicking the Decline button
curl 'https://app.daytona.io/api/organizations/invitations/INVITATION_ID/decline' \ --request POST \ --header 'Authorization: Bearer YOUR_API_KEY'List pending
Section titled “List pending”List pending invitations for an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/invitations' \ --header 'Authorization: Bearer YOUR_API_KEY'Update invitation
Section titled “Update invitation”Update an invitation for an organization.
- Go to Daytona Dashboard ↗
- Scroll to the Invitations table
- Click the three-dot menu on the invitation row
- Click Edit
- Update the role or assignments and click Update
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/invitations/INVITATION_ID' \ --request PUT \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "role": "member", "assignedRoleIds": ["00000000-0000-0000-0000-000000000001"], "expiresAt": "2030-01-01T00:00:00.000Z"}'Cancel invitation
Section titled “Cancel invitation”Cancel an invitation for an organization.
- Go to Daytona Dashboard ↗
- Scroll to the Invitations table
- Click the three-dot menu on the invitation row
- Click Cancel
- Confirm by clicking the Confirm button
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/invitations/INVITATION_ID/cancel' \ --request POST \ --header 'Authorization: Bearer YOUR_API_KEY'Regions
Section titled “Regions”Each organization has a default region that determines where sandboxes are created when no specific target is provided. Regions represent geographic or logical groupings of compute infrastructure. Organizations can update their default region, manage per-region resource quotas, and query region quota information for individual sandboxes.
For more information on available region types, see the Regions guide.
Set default region
Section titled “Set default region”Set the default region.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/default-region' \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "defaultRegionId": "us"}'Organization settings
Section titled “Organization settings”The settings page in the Daytona Dashboard ↗ allows you to view the organization ID and name, and optionally delete the organization if you don’t need it anymore. This action is irreversible, so please proceed with caution. Personal organizations are there by default and cannot be deleted.
Advanced operations
Section titled “Advanced operations”Daytona provides methods to perform advanced operations on an organization.
Usage overview
Section titled “Usage overview”Get the usage overview for an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/usage' \ --header 'Authorization: Bearer YOUR_API_KEY'Update sandbox default limited network egress
Section titled “Update sandbox default limited network egress”Update the sandbox default limited network egress for an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/sandbox-default-limited-network-egress' \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "sandboxDefaultLimitedNetworkEgress": true}'Update experimental configuration
Section titled “Update experimental configuration”Update the experimental configuration for an organization.
curl 'https://app.daytona.io/api/organizations/ORGANIZATION_ID/experimental-config' \ --request PUT \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "otel": { "endpoint": "http://otel-collector:4317", "headers": { "api-key": "XXX" } }}'