Daytona

Daytona Secret API

The secret API from Daytona — 3 operation(s) for secret.

GitHub OpenAPI

Operations 6

GET /secret List secrets #
POST /secret Create secret #
GET /secret/paginated List secrets with pagination #
DELETE /secret/{secretId} Delete secret #
GET /secret/{secretId} Get secret #
PATCH /secret/{secretId} Update secret #

Documentation

📖
Documentation
https://www.daytona.io/docs/en/sandboxes
📖
APIReference
https://www.daytona.io/docs/en/tools/api/
📖
Documentation
https://www.daytona.io/docs/en/agent-tools/file-system
📖
Documentation
https://www.daytona.io/docs/en/agent-tools/git
📖
Documentation
https://www.daytona.io/docs/en/agent-tools/language-server-protocol
📖
Documentation
https://www.daytona.io/docs/en/agent-tools/process-execution
📖
Documentation
https://www.daytona.io/docs/en/agent-tools/computer-use
📖
Documentation
https://www.daytona.io/docs/en/snapshots
📖
Documentation
https://www.daytona.io/docs/en/volumes
📖
Documentation
https://www.daytona.io/docs/en/preview
📖
Documentation
https://www.daytona.io/docs/en/webhooks
📖
Documentation
https://www.daytona.io/docs/en/account-management/organizations
📖
Documentation
https://www.daytona.io/docs/en/account-management/api-keys
📖
Documentation
https://www.daytona.io/docs/en/account-management/linked-accounts
📖
Documentation
https://www.daytona.io/docs/en/deployments/customer-managed-compute
📖
Documentation
https://www.daytona.io/docs/en/security/audit-logs
📖
Documentation
https://www.daytona.io/docs/en/observability/opentelemetry-collection

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/openapi/daytona-io-secret-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/json-schema/daytona-sandbox-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/json-structure/daytona-sandbox-structure.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/examples/daytona-sandbox-create-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/daytona-io:daytona-io-secret-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

daytona-io-secret-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: support@daytona.com
    name: Daytona Platforms Inc.
    url: https://www.daytona.io
  description: Daytona AI platform API Docs
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  title: Daytona Secret API
  version: '1.0'
servers:
- url: http://localhost:3000
tags:
- name: Secret
paths:
  /secret:
    get:
      deprecated: true
      description: This endpoint is deprecated and fails for organizations with more than 1500 secrets. Use `listSecretsPaginated` instead.
      operationId: listSecrets
      parameters:
      - description: Use with JWT to specify the organization ID
        explode: false
        in: header
        name: X-Daytona-Organization-ID
        required: false
        schema:
          type: string
        style: simple
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Secret'
                type: array
          description: List of all secrets (metadata only, values are not returned)
      security:
      - bearer: []
      - oauth2:
        - openid
        - profile
        - email
      summary: List secrets
      tags:
      - Secret
    post:
      operationId: createSecret
      parameters:
      - description: Use with JWT to specify the organization ID
        explode: false
        in: header
        name: X-Daytona-Organization-ID
        required: false
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSecret'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Secret'
          description: The secret has been successfully created.
      security:
      - bearer: []
      - oauth2:
        - openid
        - profile
        - email
      summary: Create secret
      tags:
      - Secret
  /secret/paginated:
    get:
      operationId: listSecretsPaginated
      parameters:
      - description: Use with JWT to specify the organization ID
        explode: false
        in: header
        name: X-Daytona-Organization-ID
        required: false
        schema:
          type: string
        style: simple
      - description: Pagination cursor from a previous response
        explode: true
        in: query
        name: cursor
        required: false
        schema:
          type: string
        style: form
      - description: Number of results per page
        explode: true
        in: query
        name: limit
        required: false
        schema:
          default: 100
          maximum: 200
          minimum: 1
          type: integer
        style: form
      - description: Filter by partial name match
        explode: true
        in: query
        name: name
        required: false
        schema:
          example: MY_API_KEY
          type: string
        style: form
      - description: Field to sort by
        explode: true
        in: query
        name: sort
        required: false
        schema:
          default: createdAt
          enum:
          - name
          - createdAt
          - updatedAt
          type: string
        style: form
      - description: Direction to sort by
        explode: true
        in: query
        name: order
        required: false
        schema:
          default: desc
          enum:
          - asc
          - desc
          type: string
        style: form
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSecretsResponse'
          description: Paginated list of secrets (metadata only, values are not returned)
      security:
      - bearer: []
      - oauth2:
        - openid
        - profile
        - email
      summary: List secrets with pagination
      tags:
      - Secret
  /secret/{secretId}:
    delete:
      operationId: deleteSecret
      parameters:
      - description: Use with JWT to specify the organization ID
        explode: false
        in: header
        name: X-Daytona-Organization-ID
        required: false
        schema:
          type: string
        style: simple
      - description: ID of the secret
        explode: false
        in: path
        name: secretId
        required: true
        schema:
          type: string
        style: simple
      responses:
        '204':
          description: The secret has been successfully deleted.
      security:
      - bearer: []
      - oauth2:
        - openid
        - profile
        - email
      summary: Delete secret
      tags:
      - Secret
    get:
      operationId: getSecret
      parameters:
      - description: Use with JWT to specify the organization ID
        explode: false
        in: header
        name: X-Daytona-Organization-ID
        required: false
        schema:
          type: string
        style: simple
      - description: ID of the secret
        explode: false
        in: path
        name: secretId
        required: true
        schema:
          type: string
        style: simple
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Secret'
          description: The secret metadata (value is not returned)
      security:
      - bearer: []
      - oauth2:
        - openid
        - profile
        - email
      summary: Get secret
      tags:
      - Secret
    patch:
      operationId: updateSecret
      parameters:
      - description: Use with JWT to specify the organization ID
        explode: false
        in: header
        name: X-Daytona-Organization-ID
        required: false
        schema:
          type: string
        style: simple
      - description: ID of the secret
        explode: false
        in: path
        name: secretId
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSecret'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Secret'
          description: The secret has been successfully updated.
      security:
      - bearer: []
      - oauth2:
        - openid
        - profile
        - email
      summary: Update secret
      tags:
      - Secret
components:
  schemas:
    UpdateSecret:
      example:
        hosts:
        - api.anthropic.com
        description: description
        value: value
      properties:
        value:
          description: New secret value
          type: string
        description:
          description: Optional description of the secret
          type: string
        hosts:
          description: Allowed hosts this secret may be sent to
          example:
          - api.anthropic.com
          items:
            type: string
          type: array
      type: object
    CreateSecret:
      example:
        hosts:
        - api.anthropic.com
        name: MY_API_KEY
        description: description
        value: value
      properties:
        name:
          description: Secret name (alphanumeric, hyphens, underscores)
          example: MY_API_KEY
          type: string
        value:
          description: Secret value
          type: string
        description:
          description: Optional description of the secret
          type: string
        hosts:
          description: Allowed hosts this secret may be sent to
          example:
          - api.anthropic.com
          items:
            type: string
          type: array
      required:
      - name
      - value
      type: object
    ListSecretsResponse:
      example:
        nextCursor: nextCursor
        total: 0
        items:
        - createdAt: '2024-01-31T12:00:00.000Z'
          hosts:
          - api.anthropic.com
          name: MY_API_KEY
          description: API key for external service
          id: 123e4567-e89b-12d3-a456-426614174000
          placeholder: dtn_secret_a7f3b2c1e9d4f6g8
          updatedAt: '2024-01-31T12:00:00.000Z'
        - createdAt: '2024-01-31T12:00:00.000Z'
          hosts:
          - api.anthropic.com
          name: MY_API_KEY
          description: API key for external service
          id: 123e4567-e89b-12d3-a456-426614174000
          placeholder: dtn_secret_a7f3b2c1e9d4f6g8
          updatedAt: '2024-01-31T12:00:00.000Z'
      properties:
        items:
          description: List of results for the current page
          items:
            $ref: '#/components/schemas/Secret'
          type: array
        total:
          description: Total number of secrets matching the filters
          type: integer
        nextCursor:
          description: Cursor for the next page of results
          type:
          - string
          - 'null'
      required:
      - items
      - nextCursor
      - total
      type: object
    Secret:
      example:
        createdAt: '2024-01-31T12:00:00.000Z'
        hosts:
        - api.anthropic.com
        name: MY_API_KEY
        description: API key for external service
        id: 123e4567-e89b-12d3-a456-426614174000
        placeholder: dtn_secret_a7f3b2c1e9d4f6g8
        updatedAt: '2024-01-31T12:00:00.000Z'
      properties:
        id:
          description: Secret ID
          example: 123e4567-e89b-12d3-a456-426614174000
          type: string
        name:
          description: Secret name
          example: MY_API_KEY
          type: string
        description:
          description: Optional description of the secret
          example: API key for external service
          type: string
        createdAt:
          description: Creation timestamp
          example: '2024-01-31T12:00:00.000Z'
          format: date-time
          type: string
        placeholder:
          description: Opaque placeholder token injected as env var value in sandboxes
          example: dtn_secret_a7f3b2c1e9d4f6g8
          type: string
        hosts:
          description: Allowed hosts this secret may be sent to
          example:
          - api.anthropic.com
          items:
            type: string
          type: array
        updatedAt:
          description: Last update timestamp
          example: '2024-01-31T12:00:00.000Z'
          format: date-time
          type: string
      required:
      - createdAt
      - hosts
      - id
      - name
      - placeholder
      - updatedAt
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: API Key access
      scheme: bearer
      type: http
    oauth2:
      openIdConnectUrl: http://localhost:3000/.well-known/openid-configuration
      type: openIdConnect
x-provenance:
  method: harvested
  publisher: Daytona
  source: https://www.daytona.io/docs/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)