Admin

List all runners

GET/admin/runners

Authorization

AuthorizationBearer <token>

API Key access

In: header

Query Parameters

regionId?string

Filter runners by region ID

`application/json`

curl -X GET "https://example.com/admin/runners"

[  {    "id": "runner123",    "domain": "runner1.example.com",    "apiUrl": "https://api.runner1.example.com",    "proxyUrl": "https://proxy.runner1.example.com",    "cpu": 8,    "memory": 16,    "disk": 100,    "gpu": 1,    "gpuType": "string",    "sandboxClass": "linux-vm",    "currentCpuUsagePercentage": 45.6,    "currentMemoryUsagePercentage": 68.2,    "currentDiskUsagePercentage": 33.8,    "currentAllocatedCpu": 4000,    "currentAllocatedMemoryGiB": 8000,    "currentAllocatedDiskGiB": 50000,    "currentSnapshotCount": 12,    "currentStartedSandboxes": 5,    "availabilityScore": 85,    "region": "us",    "name": "runner1",    "state": "initializing",    "lastChecked": "2024-10-01T12:00:00Z",    "unschedulable": false,    "tags": [      "gpu",      "us-east"    ],    "createdAt": "2023-10-01T12:00:00Z",    "updatedAt": "2023-10-01T12:00:00Z",    "version": "0",    "apiVersion": "0",    "runnerClass": "container",    "appVersion": "v0.0.0-dev",    "class": "small",    "apiKey": "dtn_1234567890",    "regionType": "shared"  }]

Create runner

POST/admin/runners

Authorization

AuthorizationBearer <token>

API Key access

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

regionId*string

name*string

tags?array<string>

Tags to associate with the runner

apiKey*string

apiVersion*string

The api version of the runner to create

Match^(0|2)$

domain?string

The domain of the runner

apiUrl?string

The API URL of the runner

proxyUrl?string

The proxy URL of the runner

cpu?number

The CPU capacity of the runner

memoryGiB?number

The memory capacity of the runner in GiB

diskGiB?number

The disk capacity of the runner in GiB

`application/json`

curl -X POST "https://example.com/admin/runners" \  -H "Content-Type: application/json" \  -d '{    "regionId": "string",    "name": "string",    "apiKey": "string",    "apiVersion": "2"  }'

{  "id": "runner123",  "apiKey": "dtn_1234567890"}

Get runner by ID

GET/admin/runners/{id}

Authorization

AuthorizationBearer <token>

API Key access

In: header

`application/json`

curl -X GET "https://example.com/admin/runners/string"

{  "id": "runner123",  "domain": "runner1.example.com",  "apiUrl": "https://api.runner1.example.com",  "proxyUrl": "https://proxy.runner1.example.com",  "cpu": 8,  "memory": 16,  "disk": 100,  "gpu": 1,  "gpuType": "string",  "sandboxClass": "linux-vm",  "currentCpuUsagePercentage": 45.6,  "currentMemoryUsagePercentage": 68.2,  "currentDiskUsagePercentage": 33.8,  "currentAllocatedCpu": 4000,  "currentAllocatedMemoryGiB": 8000,  "currentAllocatedDiskGiB": 50000,  "currentSnapshotCount": 12,  "currentStartedSandboxes": 5,  "availabilityScore": 85,  "region": "us",  "name": "runner1",  "state": "initializing",  "lastChecked": "2024-10-01T12:00:00Z",  "unschedulable": false,  "tags": [    "gpu",    "us-east"  ],  "createdAt": "2023-10-01T12:00:00Z",  "updatedAt": "2023-10-01T12:00:00Z",  "version": "0",  "apiVersion": "0",  "runnerClass": "container",  "appVersion": "v0.0.0-dev",  "class": "small",  "apiKey": "dtn_1234567890",  "regionType": "shared"}

Update runner scheduling status

PATCH/admin/runners/{id}/scheduling

Authorization

AuthorizationBearer <token>

API Key access

In: header

Recover sandbox from error state as an admin

POST/admin/sandbox/{sandboxId}/recover

Authorization

AuthorizationBearer <token>

API Key access

In: header

`application/json`

curl -X POST "https://example.com/admin/sandbox/string/recover"

{  "id": "sandbox123",  "organizationId": "organization123",  "name": "MySandbox",  "snapshot": "daytonaio/sandbox:latest",  "user": "daytona",  "env": {    "NODE_ENV": "production"  },  "labels": {    "daytona.io/public": "true"  },  "public": false,  "networkBlockAll": false,  "networkAllowList": "192.168.1.0/16,10.0.0.0/24",  "domainAllowList": "example.com,*.daytona.io",  "outboundProxyUrl": "http://user:pass@proxy.example.com:3128",  "otelEndpointOverride": "https://otel-collector.example.com:4318",  "target": "local",  "cpu": 2,  "gpu": 0,  "spot": false,  "spotEvictedAt": "2026-08-13T12:00:00.000Z",  "gpuType": "H100",  "memory": 4,  "disk": 10,  "state": "creating",  "desiredState": "destroyed",  "errorReason": "The sandbox is not running",  "recoverable": true,  "warmPoolId": "string",  "backupState": "None",  "backupCreatedAt": "2024-10-01T12:00:00Z",  "autoStopInterval": 30,  "autoPauseInterval": 60,  "autoArchiveInterval": 10080,  "autoDeleteInterval": 30,  "autoDestroyAt": "2026-07-15T12:00:00.000Z",  "volumes": [    {      "volumeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",      "mountPath": "/data",      "subpath": "users/alice"    }  ],  "buildInfo": {    "dockerfileContent": "FROM node:14\nWORKDIR /app\nCOPY . .\nRUN npm install\nCMD [\"npm\", \"start\"]",    "contextHashes": [      "hash1",      "hash2"    ],    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "snapshotRef": "daytonaio/sandbox:latest"  },  "createdAt": "2024-10-01T12:00:00Z",  "updatedAt": "2024-10-01T12:00:00Z",  "lastActivityAt": "2024-10-01T12:00:00Z",  "sandboxClass": "linux-vm",  "daemonVersion": "1.0.0",  "runnerId": "runner123",  "linkedSandboxId": "sandbox123",  "toolboxProxyUrl": "https://proxy.app.daytona.io/toolbox"}

Get user by ID

GET/admin/users/{id}

Authorization

AuthorizationBearer <token>

API Key access

In: header

`application/json`

curl -X GET "https://example.com/admin/users/string"

{  "id": "string",  "name": "string",  "email": "string",  "emailVerified": true,  "pylonEmailHash": "string",  "publicKeys": [    {      "key": "string",      "name": "string"    }  ],  "createdAt": "2019-08-24T14:15:22Z"}

Send a webhook message to an organization

POST/admin/webhooks/organizations/{organizationId}/send

Authorization

AuthorizationBearer <token>

API Key access

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

eventType*string

The type of event being sent

Value in

"sandbox.created"
"sandbox.state.updated"
"snapshot.created"
"snapshot.state.updated"
"snapshot.removed"
"volume.created"
"volume.state.updated"

payload*

The payload data to send

eventId?string

Optional event ID for idempotency

Get delivery attempts for a webhook message

GET/admin/webhooks/organizations/{organizationId}/messages/{messageId}/attempts

Authorization

AuthorizationBearer <token>

API Key access

In: header

`application/json`

curl -X GET "https://example.com/admin/webhooks/organizations/string/messages/string/attempts"

[  {}]

Get webhook service status

GET/admin/webhooks/status

Authorization

AuthorizationBearer <token>

API Key access

In: header

`application/json`

curl -X GET "https://example.com/admin/webhooks/status"

{  "enabled": true}

Initialize webhooks for an organization

POST/admin/webhooks/organizations/{organizationId}/initialize

Authorization

AuthorizationBearer <token>

API Key access

In: header

Set default registry

POST/admin/docker-registry/{id}/set-default

Authorization

AuthorizationBearer <token>

API Key access

In: header

`application/json`

curl -X POST "https://example.com/admin/docker-registry/string/set-default"

{  "id": "123e4567-e89b-12d3-a456-426614174000",  "name": "My Docker Hub",  "url": "https://registry.hub.docker.com",  "username": "username",  "project": "my-project",  "registryType": "internal",  "createdAt": "2024-01-31T12:00:00Z",  "updatedAt": "2024-01-31T12:00:00Z"}

Check if an image can be cleaned up

GET/admin/snapshots/can-cleanup-image

Authorization

AuthorizationBearer <token>

API Key access

In: header

Query Parameters

imageName*string

Image name with tag to check

`application/json`

curl -X GET "https://example.com/admin/snapshots/can-cleanup-image?imageName=string"

true

Set snapshot general status

PATCH/admin/snapshots/{id}/general

Authorization

AuthorizationBearer <token>

API Key access

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

general*boolean

Whether the snapshot is general

`application/json`

curl -X PATCH "https://example.com/admin/snapshots/string/general" \  -H "Content-Type: application/json" \  -d '{    "general": true  }'

{  "id": "string",  "organizationId": "string",  "general": true,  "name": "string",  "imageName": "string",  "state": "building",  "size": 0,  "entrypoint": [    "string"  ],  "cpu": 0,  "gpu": 0,  "gpuType": "H100",  "mem": 0,  "disk": 0,  "errorReason": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "lastUsedAt": "2019-08-24T14:15:22Z",  "buildInfo": {    "dockerfileContent": "FROM node:14\nWORKDIR /app\nCOPY . .\nRUN npm install\nCMD [\"npm\", \"start\"]",    "contextHashes": [      "hash1",      "hash2"    ],    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "snapshotRef": "daytonaio/sandbox:latest"  },  "regionIds": [    "string"  ],  "initialRunnerId": "runner123",  "ref": "daytonaio/sandbox:latest",  "sourceSandboxId": "sandbox123",  "sandboxClass": "linux-vm"}

Get all audit logs

GET/admin/audit

Authorization

AuthorizationBearer <token>

API Key access

In: header

Query Parameters

page?number

Page number of the results

Range1 <= value

Default1

limit?number

Number of results per page

Range1 <= value <= 200

Default100

from?string

Deprecated

Deprecated alias for createdAt[gte]. From date (ISO 8601 format).

Formatdate-time

to?string

Deprecated

Deprecated alias for createdAt[lte]. To date (ISO 8601 format).

Formatdate-time

nextToken?string

Token for cursor-based pagination. When provided, takes precedence over page parameter.

id?

Filter by audit log ID.

actorId?

Filter by actor user ID.

actorEmail?

Filter by actor email.

actorApiKeyPrefix?

Filter by actor API key prefix.

actorApiKeySuffix?

Filter by actor API key suffix.

action?

Filter by action.

targetType?

Filter by target type.

targetId?

Filter by target ID.

statusCode?

Filter by HTTP status code.

createdAt?

Filter by creation timestamp.

`application/json`

curl -X GET "https://example.com/admin/audit"

{  "items": [    {      "id": "string",      "actorId": "string",      "actorEmail": "string",      "actorApiKeyPrefix": "string",      "actorApiKeySuffix": "string",      "organizationId": "string",      "action": "string",      "targetType": "string",      "targetId": "string",      "statusCode": 0,      "errorMessage": "string",      "ipAddress": "string",      "userAgent": "string",      "source": "string",      "metadata": {},      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0,  "page": 0,  "totalPages": 0,  "nextToken": "string"}

Create organization for user

POST/admin/organizations

Authorization

AuthorizationBearer <token>

API Key access

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

userId*string

The ID of the user the organization will be created for

name*string

The name of organization

defaultRegionId*string

The ID of the default region for the organization

`application/json`

curl -X POST "https://example.com/admin/organizations" \  -H "Content-Type: application/json" \  -d '{    "userId": "user_123",    "name": "My Organization",    "defaultRegionId": "us"  }'

{  "id": "string",  "name": "string",  "createdBy": "string",  "personal": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "suspended": true,  "suspendedAt": "2019-08-24T14:15:22Z",  "suspensionReason": "string",  "suspendedUntil": "2019-08-24T14:15:22Z",  "suspensionCleanupGracePeriodHours": 0,  "maxCpuPerSandbox": 0,  "maxMemoryPerSandbox": 0,  "maxDiskPerSandbox": 0,  "secretQuota": 0,  "maxSecretsPerSandbox": 0,  "snapshotDeactivationTimeoutMinutes": 20160,  "sandboxLimitedNetworkEgress": true,  "previewWarningEnabled": true,  "ssoEnabled": true,  "defaultRegionId": "string",  "authenticatedRateLimit": 0,  "sandboxCreateRateLimit": 0,  "sandboxLifecycleRateLimit": 0,  "experimentalConfig": {},  "otelConfig": {    "endpoint": "string",    "headers": {      "x-api-key": "my-api-key"    },    "organizationId": "string"  },  "authenticatedRateLimitTtlSeconds": 0,  "sandboxCreateRateLimitTtlSeconds": 0,  "sandboxLifecycleRateLimitTtlSeconds": 0}

Create organization region quota

POST/admin/organizations/{organizationId}/quota/{regionId}

Authorization

AuthorizationBearer <token>

API Key access

In: header

Path Parameters

organizationId*string

Organization ID

regionId*string

ID of the region the new quota applies to

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

sandboxClass*string

Value in

"linux-vm"
"container"
"android"
"windows"

totalCpuQuota*number

totalMemoryQuota*number

totalDiskQuota*number

totalGpuQuota*number

allowedGpuTypes?array<>|null

maxCpuPerSandbox?number|null

maxMemoryPerSandbox?number|null

maxDiskPerSandbox?number|null

maxDiskPerNonEphemeralSandbox?number|null

maxCpuPerGpu?|

CPU maximum per requested GPU unit for GPU sandboxes.

maxMemoryPerGpu?|

Memory maximum per requested GPU unit for GPU sandboxes.

maxDiskPerGpu?|

Disk maximum per requested GPU unit for GPU sandboxes.

maxSandboxLifespan?|

Maximum sandbox lifespan in minutes, measured from sandbox creation to its auto-destroy deadline. If null or 0, lifespan is unrestricted. When set, sandboxes created without a TTL default to this lifespan and TTL cannot be disabled.

Response Body

`application/json`

curl -X POST "https://example.com/admin/organizations/string/quota/string" \  -H "Content-Type: application/json" \  -d '{    "sandboxClass": "linux-vm",    "totalCpuQuota": 0,    "totalMemoryQuota": 0,    "totalDiskQuota": 0,    "totalGpuQuota": 0  }'

{  "organizationId": "string",  "regionId": "string",  "sandboxClass": "linux-vm",  "totalCpuQuota": 0,  "totalMemoryQuota": 0,  "totalDiskQuota": 0,  "totalGpuQuota": 0,  "allowedGpuTypes": [    "H100"  ],  "maxCpuPerSandbox": 0,  "maxMemoryPerSandbox": 0,  "maxDiskPerSandbox": 0,  "maxDiskPerNonEphemeralSandbox": 0,  "maxCpuPerGpu": 0,  "maxMemoryPerGpu": 0,  "maxDiskPerGpu": 0,  "maxSandboxLifespan": 0}

Update organization region quota

PATCH/admin/organizations/{organizationId}/quota/{regionId}

Authorization

AuthorizationBearer <token>

API Key access

In: header

Path Parameters

organizationId*string

Organization ID

regionId*string

Region ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

sandboxClass?string

Value in

"linux-vm"
"container"
"android"
"windows"

totalCpuQuota*number|null

totalMemoryQuota*number|null

totalDiskQuota*number|null

totalGpuQuota*number|null

allowedGpuTypes?array<>|null

maxCpuPerSandbox?number|null

maxMemoryPerSandbox?number|null

maxDiskPerSandbox?number|null

maxDiskPerNonEphemeralSandbox?number|null

maxCpuPerGpu?|

CPU maximum per requested GPU unit for GPU sandboxes.

maxMemoryPerGpu?|

Memory maximum per requested GPU unit for GPU sandboxes.

maxDiskPerGpu?|

Disk maximum per requested GPU unit for GPU sandboxes.

maxSandboxLifespan?|

Response Body

curl -X PATCH "https://example.com/admin/organizations/string/quota/string" \  -H "Content-Type: application/json" \  -d '{    "totalCpuQuota": 0,    "totalMemoryQuota": 0,    "totalDiskQuota": 0,    "totalGpuQuota": 0  }'

Empty

Get organization region quota

GET/admin/organizations/{organizationId}/quota/{regionId}/{sandboxClass}

Authorization

AuthorizationBearer <token>

API Key access

In: header

Path Parameters

organizationId*string

Organization ID

regionId*string

Region ID

sandboxClass*string

Sandbox class

Value in

"linux-vm"
"container"
"android"
"windows"

Response Body

`application/json`

curl -X GET "https://example.com/admin/organizations/string/quota/string/linux-vm"

{  "organizationId": "string",  "regionId": "string",  "sandboxClass": "linux-vm",  "totalCpuQuota": 0,  "totalMemoryQuota": 0,  "totalDiskQuota": 0,  "totalGpuQuota": 0,  "allowedGpuTypes": [    "H100"  ],  "maxCpuPerSandbox": 0,  "maxMemoryPerSandbox": 0,  "maxDiskPerSandbox": 0,  "maxDiskPerNonEphemeralSandbox": 0,  "maxCpuPerGpu": 0,  "maxMemoryPerGpu": 0,  "maxDiskPerGpu": 0,  "maxSandboxLifespan": 0}

Delete organization region quota

DELETE/admin/organizations/{organizationId}/quota/{regionId}/{sandboxClass}

Authorization

AuthorizationBearer <token>

API Key access

In: header

Path Parameters

organizationId*string

Organization ID

regionId*string

Region ID

sandboxClass*string

Sandbox class

Value in

"linux-vm"
"container"
"android"
"windows"

Response Body

curl -X DELETE "https://example.com/admin/organizations/string/quota/string/linux-vm"

Empty

Update organization preview warning

POST/admin/organizations/{organizationId}/preview-warning

Authorization

AuthorizationBearer <token>

API Key access

In: header

Path Parameters

organizationId*string

Organization ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

previewWarningEnabled*boolean

Whether the proxy shows the preview URL warning page for this organization

Response Body

curl -X POST "https://example.com/admin/organizations/string/preview-warning" \  -H "Content-Type: application/json" \  -d '{    "previewWarningEnabled": true  }'

Empty

Admin

200application/json

201application/json

200application/json

204

204

200application/json

200

201

201

200application/json

200

200application/json

200application/json

201

404

200application/json

200application/json

200application/json

200application/json

201application/json

201application/json

204

200application/json

204

204

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`