SecretService

Service for managing organization-scoped Daytona Secrets.

Secrets can be created, listed, retrieved, updated, and deleted, and referenced when creating a Sandbox via the secrets field on the create-sandbox parameters. The plaintext value is write-only and is never returned by the API; the Sandbox only ever sees the Secret’s opaque placeholder, and the real value is substituted at the network egress layer for the Secret’s allowed hosts.

Methods

create()

public Secret create(CreateSecretParams params)

Creates a new Secret.

Parameters:

• params CreateSecretParams - creation parameters; name must match ^[a-zA-Z_][a-zA-Z0-9_-]*$ and be unique within the organization

Returns:

• Secret - created Secret (without the plaintext value)

Throws:

• io.daytona.sdk.exception.DaytonaConflictException - if a Secret with the same name already exists
• io.daytona.sdk.exception.DaytonaException - if creation fails

list()

public List<Secret> list()

Lists all Secrets in the organization.

Returns:

• List\<Secret\> - list of Secrets

Throws:

• io.daytona.sdk.exception.DaytonaException - if the API request fails

get()

public Secret get(String secretId)

Retrieves a Secret by ID.

Parameters:

• secretId String - Secret identifier

Returns:

• Secret - matching Secret

Throws:

• io.daytona.sdk.exception.DaytonaNotFoundException - if no Secret with the given ID exists
• io.daytona.sdk.exception.DaytonaException - if the request fails

update()

public Secret update(String secretId, UpdateSecretParams params)

Updates an existing Secret. Omitted (null) fields are left unchanged.

Parameters:

• secretId String - Secret identifier
• params UpdateSecretParams - fields to update

Returns:

• Secret - updated Secret

Throws:

• io.daytona.sdk.exception.DaytonaNotFoundException - if no Secret with the given ID exists
• io.daytona.sdk.exception.DaytonaException - if the request fails

delete()

public void delete(String secretId)

Deletes a Secret by ID.

Parameters:

• secretId String - Secret identifier

Throws:

• io.daytona.sdk.exception.DaytonaNotFoundException - if no Secret with the given ID exists
• io.daytona.sdk.exception.DaytonaException - if deletion fails