For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.security.list_secret_versions(secret="my-database-password", region=None)

Description

To list all versions of a secret, send a GET request to /v2/security/secrets/{secret}/versions.

Parameters

secret string required

The name of the secret.

region string optional

The slug identifier for the region where the resource is available.

One of: ams1, ams2, ams3, blr1, fra1, lon1, nyc1, nyc2, nyc3, sfo1, sfo2, sfo3, sgp1, tor1, syd1

Response Example

{
  "versions": [
    {
      "version": 1,
      "created_at": "2025-12-04T00:00:00Z",
      "updated_at": "2025-12-04T00:00:00Z"
    }
  ]
}

More Information

See /v2/security/secrets/{secret}/versions in the API reference for additional detail on responses, headers, parameters, and more.