Containers · 4 November 2026

Versions, and Cloud Run revisions

GET /v2/containers/{id}/versions returns a container's versions, newest first and paginated with limit (1 to 100, default 20) and cursor. GET /v2/container-versions/{id} returns one version by its ID, which is the container's ID, a dot, and the version's number (ctr_....3). Both accept the container's slug in place of its ID and require the key's containers:get permission. Each version returns its number, state (building, warming, ready, live, failed or superseded), image, imageDigest, failure, the container generation that made it, and the container's labels. The SDKs read them with containers.versions(id) and containers.version(id). In the Google Cloud Run Admin API at /compat/google-cloud-run, services.revisions.list (paginated with pageSize and pageToken) and services.revisions.get now return these versions as revisions named <service>-<version>, and v1's namespaces.revisions.get (gcloud run revisions describe) returns one as a Knative Revision. A revision of another service, location or project returns 404. Deleting a revision is not yet available, and v1's revisions list returns 404.