Daytona · Capability

Daytona Sandbox Lifecycle

Daytona Sandbox Lifecycle. 40 operations. Lead operation: List all sandboxes. Self-contained Naftiko capability covering one Daytona business surface.

Daytona Sandbox Lifecycle is a Naftiko capability published by Daytona, one of 16 capabilities the APIs.io network indexes for this provider. It bundles 40 operations across the GET, POST, DELETE, and PUT methods rooted at /v1/sandbox.

The capability includes 19 read-only operations and 21 state-changing operations. Lead operation: List all sandboxes. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Daytona and Sandbox.

Run with Naftiko DaytonaSandbox

What You Can Do

GET
Listsandboxes — List all sandboxes
/v1/sandbox
POST
Createsandbox — Create a new sandbox
/v1/sandbox
GET
Listsandboxespaginated — List all sandboxes paginated
/v1/sandbox/paginated
GET
Getsandboxesforrunner — Get sandboxes for the authenticated runner
/v1/sandbox/for-runner
GET
Getsandbox — Get sandbox details
/v1/sandbox/{sandboxIdOrName}
DELETE
Deletesandbox — Delete sandbox
/v1/sandbox/{sandboxIdOrName}
POST
Recoversandbox — Recover sandbox from error state
/v1/sandbox/{sandboxIdOrName}/recover
POST
Startsandbox — Start sandbox
/v1/sandbox/{sandboxIdOrName}/start
POST
Stopsandbox — Stop sandbox
/v1/sandbox/{sandboxIdOrName}/stop
POST
Resizesandbox — Resize sandbox resources
/v1/sandbox/{sandboxIdOrName}/resize
PUT
Replacelabels — Replace sandbox labels
/v1/sandbox/{sandboxIdOrName}/labels
PUT
Updatesandboxstate — Update sandbox state
/v1/sandbox/{sandboxId}/state
POST
Createbackup — Create sandbox backup
/v1/sandbox/{sandboxIdOrName}/backup
POST
Createsandboxsnapshot — Create a snapshot from a sandbox
/v1/sandbox/{sandboxIdOrName}/snapshot
POST
Forksandbox — Fork a sandbox
/v1/sandbox/{sandboxIdOrName}/fork
GET
Getsandboxforks — Get sandbox fork children
/v1/sandbox/{sandboxIdOrName}/forks
GET
Getsandboxparent — Get sandbox fork parent
/v1/sandbox/{sandboxIdOrName}/parent
GET
Getsandboxancestors — Get sandbox fork ancestor chain
/v1/sandbox/{sandboxIdOrName}/ancestors
POST
Updatepublicstatus — Update public status
/v1/sandbox/{sandboxIdOrName}/public/{isPublic}
POST
Updatelastactivity — Update sandbox last activity
/v1/sandbox/{sandboxId}/last-activity
POST
Setautostopinterval — Set sandbox auto-stop interval
/v1/sandbox/{sandboxIdOrName}/autostop/{interval}
POST
Setautoarchiveinterval — Set sandbox auto-archive interval
/v1/sandbox/{sandboxIdOrName}/autoarchive/{interval}
POST
Setautodeleteinterval — Set sandbox auto-delete interval
/v1/sandbox/{sandboxIdOrName}/autodelete/{interval}
POST
Updatenetworksettings — Changes outbound network policy on the runner for a running sandbox (for example block all traffic, restore access, or set a CIDR allow list).
/v1/sandbox/{sandboxIdOrName}/network-settings
POST
Archivesandbox — Archive sandbox
/v1/sandbox/{sandboxIdOrName}/archive
GET
Getportpreviewurl — Get preview URL for a sandbox port
/v1/sandbox/{sandboxIdOrName}/ports/{port}/preview-url
GET
Getsignedportpreviewurl — Get signed preview URL for a sandbox port
/v1/sandbox/{sandboxIdOrName}/ports/{port}/signed-preview-url
POST
Expiresignedportpreviewurl — Expire signed preview URL for a sandbox port
/v1/sandbox/{sandboxIdOrName}/ports/{port}/signed-preview-url/{token}/expire
GET
Getbuildlogs — This endpoint is deprecated. Use `getBuildLogsUrl` instead.
/v1/sandbox/{sandboxIdOrName}/build-logs
GET
Getbuildlogsurl — Get build logs URL
/v1/sandbox/{sandboxIdOrName}/build-logs-url
POST
Createsshaccess — Create SSH access for sandbox
/v1/sandbox/{sandboxIdOrName}/ssh-access
DELETE
Revokesshaccess — Revoke SSH access for sandbox
/v1/sandbox/{sandboxIdOrName}/ssh-access
GET
Validatesshaccess — Validate SSH access for sandbox
/v1/sandbox/ssh-access/validate
GET
Gettoolboxproxyurl — Get toolbox proxy URL for a sandbox
/v1/sandbox/{sandboxId}/toolbox-proxy-url
GET
Getorganizationbysandboxid — Get organization by sandbox ID
/v1/sandbox/{sandboxId}/organization
GET
Getregionquotabysandboxid — Get region quota by sandbox ID
/v1/sandbox/{sandboxId}/region-quota
GET
Getsandboxlogs — Retrieve OTEL logs for a sandbox within a time range
/v1/sandbox/{sandboxId}/telemetry/logs
GET
Getsandboxtraces — Retrieve OTEL traces for a sandbox within a time range
/v1/sandbox/{sandboxId}/telemetry/traces
GET
Getsandboxtracespans — Retrieve all spans for a specific trace
/v1/sandbox/{sandboxId}/telemetry/traces/{traceId}
GET
Getsandboxmetrics — Retrieve OTEL metrics for a sandbox within a time range
/v1/sandbox/{sandboxId}/telemetry/metrics

MCP Tools

daytona-list-all-sandboxes

List all sandboxes

read-only idempotent
daytona-create-a-new-sandbox

Create a new sandbox

daytona-list-all-sandboxes-paginated

List all sandboxes paginated

read-only idempotent
daytona-get-sandboxes-for-the-authenticated-runner

Get sandboxes for the authenticated runner

read-only idempotent
daytona-get-sandbox-details

Get sandbox details

read-only idempotent
daytona-delete-sandbox

Delete sandbox

idempotent
daytona-recover-sandbox-from-error-state

Recover sandbox from error state

daytona-start-sandbox

Start sandbox

daytona-stop-sandbox

Stop sandbox

daytona-resize-sandbox-resources

Resize sandbox resources

daytona-replace-sandbox-labels

Replace sandbox labels

idempotent
daytona-update-sandbox-state

Update sandbox state

idempotent
daytona-create-sandbox-backup

Create sandbox backup

daytona-create-a-snapshot-from-a-sandbox

Create a snapshot from a sandbox

daytona-fork-a-sandbox

Fork a sandbox

daytona-get-sandbox-fork-children

Get sandbox fork children

read-only idempotent
daytona-get-sandbox-fork-parent

Get sandbox fork parent

read-only idempotent
daytona-get-sandbox-fork-ancestor-chain

Get sandbox fork ancestor chain

read-only idempotent
daytona-update-public-status

Update public status

daytona-update-sandbox-last-activity

Update sandbox last activity

daytona-set-sandbox-auto-stop-interval

Set sandbox auto-stop interval

daytona-set-sandbox-auto-archive-interval

Set sandbox auto-archive interval

daytona-set-sandbox-auto-delete-interval

Set sandbox auto-delete interval

daytona-update-sandbox-network-settings

Changes outbound network policy on the runner for a running sandbox (for example block all traffic, restore access, or set a CIDR allow list).

daytona-archive-sandbox

Archive sandbox

daytona-get-preview-url-for-a-sandbox-port

Get preview URL for a sandbox port

read-only idempotent
daytona-get-signed-preview-url-for-a-sandbox-port

Get signed preview URL for a sandbox port

read-only idempotent
daytona-expire-signed-preview-url-for-a-sandbox-port

Expire signed preview URL for a sandbox port

daytona-get-build-logs

This endpoint is deprecated. Use `getBuildLogsUrl` instead.

read-only idempotent
daytona-get-build-logs-url

Get build logs URL

read-only idempotent
daytona-create-ssh-access-for-sandbox

Create SSH access for sandbox

daytona-revoke-ssh-access-for-sandbox

Revoke SSH access for sandbox

idempotent
daytona-validate-ssh-access-for-sandbox

Validate SSH access for sandbox

read-only idempotent
daytona-get-toolbox-proxy-url-for-a-sandbox

Get toolbox proxy URL for a sandbox

read-only idempotent
daytona-get-organization-by-sandbox-id

Get organization by sandbox ID

read-only idempotent
daytona-get-region-quota-by-sandbox-id

Get region quota by sandbox ID

read-only idempotent
daytona-get-sandbox-logs

Retrieve OTEL logs for a sandbox within a time range

read-only idempotent
daytona-get-sandbox-traces

Retrieve OTEL traces for a sandbox within a time range

read-only idempotent
daytona-get-trace-spans

Retrieve all spans for a specific trace

read-only idempotent
daytona-get-sandbox-metrics

Retrieve OTEL metrics for a sandbox within a time range

read-only idempotent

Capability Spec

sandbox-lifecycle.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Daytona Sandbox Lifecycle
  description: 'Daytona Sandbox Lifecycle. 40 operations. Lead operation: List all sandboxes. Self-contained Naftiko capability
    covering one Daytona business surface.'
  tags:
  - Daytona
  - Sandbox
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    DAYTONA_API_KEY: DAYTONA_API_KEY
capability:
  consumes:
  - type: http
    namespace: sandbox-lifecycle
    baseUri: https://app.daytona.io/api
    description: Daytona Sandbox Lifecycle business capability. Self-contained, no shared references.
    resources:
    - name: sandbox
      path: /sandbox
      operations:
      - name: listsandboxes
        method: GET
        description: List all sandboxes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createsandbox
        method: POST
        description: Create a new sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-paginated
      path: /sandbox/paginated
      operations:
      - name: listsandboxespaginated
        method: GET
        description: List all sandboxes paginated
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-for-runner
      path: /sandbox/for-runner
      operations:
      - name: getsandboxesforrunner
        method: GET
        description: Get sandboxes for the authenticated runner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname
      path: /sandbox/{sandboxIdOrName}
      operations:
      - name: getsandbox
        method: GET
        description: Get sandbox details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletesandbox
        method: DELETE
        description: Delete sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-recover
      path: /sandbox/{sandboxIdOrName}/recover
      operations:
      - name: recoversandbox
        method: POST
        description: Recover sandbox from error state
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-start
      path: /sandbox/{sandboxIdOrName}/start
      operations:
      - name: startsandbox
        method: POST
        description: Start sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-stop
      path: /sandbox/{sandboxIdOrName}/stop
      operations:
      - name: stopsandbox
        method: POST
        description: Stop sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-resize
      path: /sandbox/{sandboxIdOrName}/resize
      operations:
      - name: resizesandbox
        method: POST
        description: Resize sandbox resources
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-sandboxidorname-labels
      path: /sandbox/{sandboxIdOrName}/labels
      operations:
      - name: replacelabels
        method: PUT
        description: Replace sandbox labels
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-sandboxid-state
      path: /sandbox/{sandboxId}/state
      operations:
      - name: updatesandboxstate
        method: PUT
        description: Update sandbox state
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-sandboxidorname-backup
      path: /sandbox/{sandboxIdOrName}/backup
      operations:
      - name: createbackup
        method: POST
        description: Create sandbox backup
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-snapshot
      path: /sandbox/{sandboxIdOrName}/snapshot
      operations:
      - name: createsandboxsnapshot
        method: POST
        description: Create a snapshot from a sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-sandboxidorname-fork
      path: /sandbox/{sandboxIdOrName}/fork
      operations:
      - name: forksandbox
        method: POST
        description: Fork a sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-sandboxidorname-forks
      path: /sandbox/{sandboxIdOrName}/forks
      operations:
      - name: getsandboxforks
        method: GET
        description: Get sandbox fork children
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-parent
      path: /sandbox/{sandboxIdOrName}/parent
      operations:
      - name: getsandboxparent
        method: GET
        description: Get sandbox fork parent
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-ancestors
      path: /sandbox/{sandboxIdOrName}/ancestors
      operations:
      - name: getsandboxancestors
        method: GET
        description: Get sandbox fork ancestor chain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-public-ispublic
      path: /sandbox/{sandboxIdOrName}/public/{isPublic}
      operations:
      - name: updatepublicstatus
        method: POST
        description: Update public status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-last-activity
      path: /sandbox/{sandboxId}/last-activity
      operations:
      - name: updatelastactivity
        method: POST
        description: Update sandbox last activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-autostop-interval
      path: /sandbox/{sandboxIdOrName}/autostop/{interval}
      operations:
      - name: setautostopinterval
        method: POST
        description: Set sandbox auto-stop interval
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-autoarchive-interval
      path: /sandbox/{sandboxIdOrName}/autoarchive/{interval}
      operations:
      - name: setautoarchiveinterval
        method: POST
        description: Set sandbox auto-archive interval
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-autodelete-interval
      path: /sandbox/{sandboxIdOrName}/autodelete/{interval}
      operations:
      - name: setautodeleteinterval
        method: POST
        description: Set sandbox auto-delete interval
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-network-settings
      path: /sandbox/{sandboxIdOrName}/network-settings
      operations:
      - name: updatenetworksettings
        method: POST
        description: Changes outbound network policy on the runner for a running sandbox (for example block all traffic, restore
          access, or set a CIDR allow list).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: sandbox-sandboxidorname-archive
      path: /sandbox/{sandboxIdOrName}/archive
      operations:
      - name: archivesandbox
        method: POST
        description: Archive sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-ports-port-preview-url
      path: /sandbox/{sandboxIdOrName}/ports/{port}/preview-url
      operations:
      - name: getportpreviewurl
        method: GET
        description: Get preview URL for a sandbox port
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-ports-port-signed-preview-url
      path: /sandbox/{sandboxIdOrName}/ports/{port}/signed-preview-url
      operations:
      - name: getsignedportpreviewurl
        method: GET
        description: Get signed preview URL for a sandbox port
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-ports-port-signed-preview-url-token-expi
      path: /sandbox/{sandboxIdOrName}/ports/{port}/signed-preview-url/{token}/expire
      operations:
      - name: expiresignedportpreviewurl
        method: POST
        description: Expire signed preview URL for a sandbox port
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-build-logs
      path: /sandbox/{sandboxIdOrName}/build-logs
      operations:
      - name: getbuildlogs
        method: GET
        description: This endpoint is deprecated. Use `getBuildLogsUrl` instead.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-build-logs-url
      path: /sandbox/{sandboxIdOrName}/build-logs-url
      operations:
      - name: getbuildlogsurl
        method: GET
        description: Get build logs URL
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxidorname-ssh-access
      path: /sandbox/{sandboxIdOrName}/ssh-access
      operations:
      - name: createsshaccess
        method: POST
        description: Create SSH access for sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: revokesshaccess
        method: DELETE
        description: Revoke SSH access for sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-ssh-access-validate
      path: /sandbox/ssh-access/validate
      operations:
      - name: validatesshaccess
        method: GET
        description: Validate SSH access for sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-toolbox-proxy-url
      path: /sandbox/{sandboxId}/toolbox-proxy-url
      operations:
      - name: gettoolboxproxyurl
        method: GET
        description: Get toolbox proxy URL for a sandbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-organization
      path: /sandbox/{sandboxId}/organization
      operations:
      - name: getorganizationbysandboxid
        method: GET
        description: Get organization by sandbox ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-region-quota
      path: /sandbox/{sandboxId}/region-quota
      operations:
      - name: getregionquotabysandboxid
        method: GET
        description: Get region quota by sandbox ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-telemetry-logs
      path: /sandbox/{sandboxId}/telemetry/logs
      operations:
      - name: getsandboxlogs
        method: GET
        description: Retrieve OTEL logs for a sandbox within a time range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-telemetry-traces
      path: /sandbox/{sandboxId}/telemetry/traces
      operations:
      - name: getsandboxtraces
        method: GET
        description: Retrieve OTEL traces for a sandbox within a time range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-telemetry-traces-traceid
      path: /sandbox/{sandboxId}/telemetry/traces/{traceId}
      operations:
      - name: getsandboxtracespans
        method: GET
        description: Retrieve all spans for a specific trace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sandbox-sandboxid-telemetry-metrics
      path: /sandbox/{sandboxId}/telemetry/metrics
      operations:
      - name: getsandboxmetrics
        method: GET
        description: Retrieve OTEL metrics for a sandbox within a time range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      value: '{{env.DAYTONA_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: sandbox-lifecycle-rest
    port: 8080
    description: REST adapter for Daytona Sandbox Lifecycle. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/sandbox
      name: sandbox
      description: REST surface for sandbox.
      operations:
      - method: GET
        name: listsandboxes
        description: List all sandboxes
        call: sandbox-lifecycle.listsandboxes
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createsandbox
        description: Create a new sandbox
        call: sandbox-lifecycle.createsandbox
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/paginated
      name: sandbox-paginated
      description: REST surface for sandbox-paginated.
      operations:
      - method: GET
        name: listsandboxespaginated
        description: List all sandboxes paginated
        call: sandbox-lifecycle.listsandboxespaginated
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/for-runner
      name: sandbox-for-runner
      description: REST surface for sandbox-for-runner.
      operations:
      - method: GET
        name: getsandboxesforrunner
        description: Get sandboxes for the authenticated runner
        call: sandbox-lifecycle.getsandboxesforrunner
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}
      name: sandbox-sandboxidorname
      description: REST surface for sandbox-sandboxidorname.
      operations:
      - method: GET
        name: getsandbox
        description: Get sandbox details
        call: sandbox-lifecycle.getsandbox
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletesandbox
        description: Delete sandbox
        call: sandbox-lifecycle.deletesandbox
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/recover
      name: sandbox-sandboxidorname-recover
      description: REST surface for sandbox-sandboxidorname-recover.
      operations:
      - method: POST
        name: recoversandbox
        description: Recover sandbox from error state
        call: sandbox-lifecycle.recoversandbox
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/start
      name: sandbox-sandboxidorname-start
      description: REST surface for sandbox-sandboxidorname-start.
      operations:
      - method: POST
        name: startsandbox
        description: Start sandbox
        call: sandbox-lifecycle.startsandbox
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/stop
      name: sandbox-sandboxidorname-stop
      description: REST surface for sandbox-sandboxidorname-stop.
      operations:
      - method: POST
        name: stopsandbox
        description: Stop sandbox
        call: sandbox-lifecycle.stopsandbox
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/resize
      name: sandbox-sandboxidorname-resize
      description: REST surface for sandbox-sandboxidorname-resize.
      operations:
      - method: POST
        name: resizesandbox
        description: Resize sandbox resources
        call: sandbox-lifecycle.resizesandbox
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/{sandboxIdOrName}/labels
      name: sandbox-sandboxidorname-labels
      description: REST surface for sandbox-sandboxidorname-labels.
      operations:
      - method: PUT
        name: replacelabels
        description: Replace sandbox labels
        call: sandbox-lifecycle.replacelabels
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/{sandboxId}/state
      name: sandbox-sandboxid-state
      description: REST surface for sandbox-sandboxid-state.
      operations:
      - method: PUT
        name: updatesandboxstate
        description: Update sandbox state
        call: sandbox-lifecycle.updatesandboxstate
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/{sandboxIdOrName}/backup
      name: sandbox-sandboxidorname-backup
      description: REST surface for sandbox-sandboxidorname-backup.
      operations:
      - method: POST
        name: createbackup
        description: Create sandbox backup
        call: sandbox-lifecycle.createbackup
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/snapshot
      name: sandbox-sandboxidorname-snapshot
      description: REST surface for sandbox-sandboxidorname-snapshot.
      operations:
      - method: POST
        name: createsandboxsnapshot
        description: Create a snapshot from a sandbox
        call: sandbox-lifecycle.createsandboxsnapshot
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/{sandboxIdOrName}/fork
      name: sandbox-sandboxidorname-fork
      description: REST surface for sandbox-sandboxidorname-fork.
      operations:
      - method: POST
        name: forksandbox
        description: Fork a sandbox
        call: sandbox-lifecycle.forksandbox
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/{sandboxIdOrName}/forks
      name: sandbox-sandboxidorname-forks
      description: REST surface for sandbox-sandboxidorname-forks.
      operations:
      - method: GET
        name: getsandboxforks
        description: Get sandbox fork children
        call: sandbox-lifecycle.getsandboxforks
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/parent
      name: sandbox-sandboxidorname-parent
      description: REST surface for sandbox-sandboxidorname-parent.
      operations:
      - method: GET
        name: getsandboxparent
        description: Get sandbox fork parent
        call: sandbox-lifecycle.getsandboxparent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/ancestors
      name: sandbox-sandboxidorname-ancestors
      description: REST surface for sandbox-sandboxidorname-ancestors.
      operations:
      - method: GET
        name: getsandboxancestors
        description: Get sandbox fork ancestor chain
        call: sandbox-lifecycle.getsandboxancestors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/public/{isPublic}
      name: sandbox-sandboxidorname-public-ispublic
      description: REST surface for sandbox-sandboxidorname-public-ispublic.
      operations:
      - method: POST
        name: updatepublicstatus
        description: Update public status
        call: sandbox-lifecycle.updatepublicstatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/last-activity
      name: sandbox-sandboxid-last-activity
      description: REST surface for sandbox-sandboxid-last-activity.
      operations:
      - method: POST
        name: updatelastactivity
        description: Update sandbox last activity
        call: sandbox-lifecycle.updatelastactivity
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/autostop/{interval}
      name: sandbox-sandboxidorname-autostop-interval
      description: REST surface for sandbox-sandboxidorname-autostop-interval.
      operations:
      - method: POST
        name: setautostopinterval
        description: Set sandbox auto-stop interval
        call: sandbox-lifecycle.setautostopinterval
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/autoarchive/{interval}
      name: sandbox-sandboxidorname-autoarchive-interval
      description: REST surface for sandbox-sandboxidorname-autoarchive-interval.
      operations:
      - method: POST
        name: setautoarchiveinterval
        description: Set sandbox auto-archive interval
        call: sandbox-lifecycle.setautoarchiveinterval
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/autodelete/{interval}
      name: sandbox-sandboxidorname-autodelete-interval
      description: REST surface for sandbox-sandboxidorname-autodelete-interval.
      operations:
      - method: POST
        name: setautodeleteinterval
        description: Set sandbox auto-delete interval
        call: sandbox-lifecycle.setautodeleteinterval
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/network-settings
      name: sandbox-sandboxidorname-network-settings
      description: REST surface for sandbox-sandboxidorname-network-settings.
      operations:
      - method: POST
        name: updatenetworksettings
        description: Changes outbound network policy on the runner for a running sandbox (for example block all traffic, restore
          access, or set a CIDR allow list).
        call: sandbox-lifecycle.updatenetworksettings
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/sandbox/{sandboxIdOrName}/archive
      name: sandbox-sandboxidorname-archive
      description: REST surface for sandbox-sandboxidorname-archive.
      operations:
      - method: POST
        name: archivesandbox
        description: Archive sandbox
        call: sandbox-lifecycle.archivesandbox
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/ports/{port}/preview-url
      name: sandbox-sandboxidorname-ports-port-preview-url
      description: REST surface for sandbox-sandboxidorname-ports-port-preview-url.
      operations:
      - method: GET
        name: getportpreviewurl
        description: Get preview URL for a sandbox port
        call: sandbox-lifecycle.getportpreviewurl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/ports/{port}/signed-preview-url
      name: sandbox-sandboxidorname-ports-port-signed-preview-url
      description: REST surface for sandbox-sandboxidorname-ports-port-signed-preview-url.
      operations:
      - method: GET
        name: getsignedportpreviewurl
        description: Get signed preview URL for a sandbox port
        call: sandbox-lifecycle.getsignedportpreviewurl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/ports/{port}/signed-preview-url/{token}/expire
      name: sandbox-sandboxidorname-ports-port-signed-preview-url-token-expi
      description: REST surface for sandbox-sandboxidorname-ports-port-signed-preview-url-token-expi.
      operations:
      - method: POST
        name: expiresignedportpreviewurl
        description: Expire signed preview URL for a sandbox port
        call: sandbox-lifecycle.expiresignedportpreviewurl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/build-logs
      name: sandbox-sandboxidorname-build-logs
      description: REST surface for sandbox-sandboxidorname-build-logs.
      operations:
      - method: GET
        name: getbuildlogs
        description: This endpoint is deprecated. Use `getBuildLogsUrl` instead.
        call: sandbox-lifecycle.getbuildlogs
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/build-logs-url
      name: sandbox-sandboxidorname-build-logs-url
      description: REST surface for sandbox-sandboxidorname-build-logs-url.
      operations:
      - method: GET
        name: getbuildlogsurl
        description: Get build logs URL
        call: sandbox-lifecycle.getbuildlogsurl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxIdOrName}/ssh-access
      name: sandbox-sandboxidorname-ssh-access
      description: REST surface for sandbox-sandboxidorname-ssh-access.
      operations:
      - method: POST
        name: createsshaccess
        description: Create SSH access for sandbox
        call: sandbox-lifecycle.createsshaccess
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: revokesshaccess
        description: Revoke SSH access for sandbox
        call: sandbox-lifecycle.revokesshaccess
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/ssh-access/validate
      name: sandbox-ssh-access-validate
      description: REST surface for sandbox-ssh-access-validate.
      operations:
      - method: GET
        name: validatesshaccess
        description: Validate SSH access for sandbox
        call: sandbox-lifecycle.validatesshaccess
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/toolbox-proxy-url
      name: sandbox-sandboxid-toolbox-proxy-url
      description: REST surface for sandbox-sandboxid-toolbox-proxy-url.
      operations:
      - method: GET
        name: gettoolboxproxyurl
        description: Get toolbox proxy URL for a sandbox
        call: sandbox-lifecycle.gettoolboxproxyurl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/organization
      name: sandbox-sandboxid-organization
      description: REST surface for sandbox-sandboxid-organization.
      operations:
      - method: GET
        name: getorganizationbysandboxid
        description: Get organization by sandbox ID
        call: sandbox-lifecycle.getorganizationbysandboxid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/region-quota
      name: sandbox-sandboxid-region-quota
      description: REST surface for sandbox-sandboxid-region-quota.
      operations:
      - method: GET
        name: getregionquotabysandboxid
        description: Get region quota by sandbox ID
        call: sandbox-lifecycle.getregionquotabysandboxid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/telemetry/logs
      name: sandbox-sandboxid-telemetry-logs
      description: REST surface for sandbox-sandboxid-telemetry-logs.
      operations:
      - method: GET
        name: getsandboxlogs
        description: Retrieve OTEL logs for a sandbox within a time range
        call: sandbox-lifecycle.getsandboxlogs
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/telemetry/traces
      name: sandbox-sandboxid-telemetry-traces
      description: REST surface for sandbox-sandboxid-telemetry-traces.
      operations:
      - method: GET
        name: getsandboxtraces
        description: Retrieve OTEL traces for a sandbox within a time range
        call: sandbox-lifecycle.getsandboxtraces
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/telemetry/traces/{traceId}
      name: sandbox-sandboxid-telemetry-traces-traceid
      description: REST surface for sandbox-sandboxid-telemetry-traces-traceid.
      operations:
      - method: GET
        name: getsandboxtracespans
        description: Retrieve all spans for a specific trace
        call: sandbox-lifecycle.getsandboxtracespans
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sandbox/{sandboxId}/telemetry/metrics
      name: sandbox-sandboxid-telemetry-metrics
      description: REST surface for sandbox-sandboxid-telemetry-metrics.
      operations:
      - method: GET
        name: getsandboxmetrics
        description: Retrieve OTEL metrics for a sandbox within a time range
        call: sandbox-lifecycle.getsandboxmetrics
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: sandbox-lifecycle-mcp
    port: 9090
    transport: http
    description: MCP adapter for Daytona Sandbox Lifecycle. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: daytona-list-all-sandboxes
      description: List all sandboxes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.listsandboxes
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-create-a-new-sandbox
      description: Create a new sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.createsandbox
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-list-all-sandboxes-paginated
      description: List all sandboxes paginated
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call:

# --- truncated at 32 KB (43 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/capabilities/sandbox-lifecycle.yaml