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: sandbox-lifecycle.listsandboxespaginated
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandboxes-for-the-authenticated-runner
      description: Get sandboxes for the authenticated runner
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxesforrunner
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandbox-details
      description: Get sandbox details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandbox
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-delete-sandbox
      description: Delete sandbox
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: sandbox-lifecycle.deletesandbox
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-recover-sandbox-from-error-state
      description: Recover sandbox from error state
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.recoversandbox
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-start-sandbox
      description: Start sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.startsandbox
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-stop-sandbox
      description: Stop sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.stopsandbox
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-resize-sandbox-resources
      description: Resize sandbox resources
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.resizesandbox
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-replace-sandbox-labels
      description: Replace sandbox labels
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.replacelabels
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-update-sandbox-state
      description: Update sandbox state
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.updatesandboxstate
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-create-sandbox-backup
      description: Create sandbox backup
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.createbackup
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-create-a-snapshot-from-a-sandbox
      description: Create a snapshot from a sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.createsandboxsnapshot
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-fork-a-sandbox
      description: Fork a sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.forksandbox
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-get-sandbox-fork-children
      description: Get sandbox fork children
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxforks
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandbox-fork-parent
      description: Get sandbox fork parent
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxparent
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandbox-fork-ancestor-chain
      description: Get sandbox fork ancestor chain
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxancestors
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-update-public-status
      description: Update public status
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.updatepublicstatus
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-update-sandbox-last-activity
      description: Update sandbox last activity
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.updatelastactivity
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-set-sandbox-auto-stop-interval
      description: Set sandbox auto-stop interval
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.setautostopinterval
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-set-sandbox-auto-archive-interval
      description: Set sandbox auto-archive interval
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.setautoarchiveinterval
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-set-sandbox-auto-delete-interval
      description: Set sandbox auto-delete interval
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.setautodeleteinterval
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-update-sandbox-network-settings
      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).
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.updatenetworksettings
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: daytona-archive-sandbox
      description: Archive sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.archivesandbox
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-preview-url-for-a-sandbox-port
      description: Get preview URL for a sandbox port
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getportpreviewurl
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-signed-preview-url-for-a-sandbox-port
      description: Get signed preview URL for a sandbox port
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsignedportpreviewurl
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-expire-signed-preview-url-for-a-sandbox-port
      description: Expire signed preview URL for a sandbox port
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.expiresignedportpreviewurl
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-build-logs
      description: This endpoint is deprecated. Use `getBuildLogsUrl` instead.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getbuildlogs
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-build-logs-url
      description: Get build logs URL
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getbuildlogsurl
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-create-ssh-access-for-sandbox
      description: Create SSH access for sandbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sandbox-lifecycle.createsshaccess
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-revoke-ssh-access-for-sandbox
      description: Revoke SSH access for sandbox
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: sandbox-lifecycle.revokesshaccess
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-validate-ssh-access-for-sandbox
      description: Validate SSH access for sandbox
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.validatesshaccess
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-toolbox-proxy-url-for-a-sandbox
      description: Get toolbox proxy URL for a sandbox
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.gettoolboxproxyurl
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-organization-by-sandbox-id
      description: Get organization by sandbox ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getorganizationbysandboxid
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-region-quota-by-sandbox-id
      description: Get region quota by sandbox ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getregionquotabysandboxid
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandbox-logs
      description: Retrieve OTEL logs for a sandbox within a time range
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxlogs
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandbox-traces
      description: Retrieve OTEL traces for a sandbox within a time range
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxtraces
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-trace-spans
      description: Retrieve all spans for a specific trace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxtracespans
      outputParameters:
      - type: object
        mapping: $.
    - name: daytona-get-sandbox-metrics
      description: Retrieve OTEL metrics for a sandbox within a time range
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sandbox-lifecycle.getsandboxmetrics
      outputParameters:
      - type: object
        mapping: $.