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.endpoint_versions.delete(
    version_id="1b4d4e0f-9a7c-4d5b-8f3c-2a6e6e8f0a13.v1",
)

Description

Deletes a live version. Only the endpoint owner may delete versions. Deleting the head makes the highest-numbered remaining live version the head. With no live versions, the endpoint MCP URL fails closed until another version is published. Inaccessible or deleted versions return 404 endpoint_version_not_found, and so does a version of a service-managed endpoint, exactly as for an unknown ID. Deletion is final for the version identity. Retries, replays, and later writes cannot resurrect it. Reusing identical contents requires a new version identity and version number.

Parameters

version_id string required

Example: 1b4d4e0f-9a7c-4d5b-8f3c-2a6e6e8f0a13.v1

Composite version ID only. Invalid IDs return 400 invalid_endpoint_version_id.

More Information

See /v2/action-gateway/endpoint-versions/{version_id} in the API reference for additional detail on responses, headers, parameters, and more.