Deployments

List every container that has ever run for an environment — current and replaced by a later redeploy. Use each entry's `container_id` (or `id`) with the `/containers/{container_id}/metrics/history` endpoint to fetch persisted metrics for a specific container generation, including ones that no longer exist because a redeploy replaced them.

Changed on
get/projects/{project_id}/environments/{environment_id}/container-history

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/projects/{project_id}/environments/{environment_id}/container-history
  • Auth: HTTP bearer

Path parameters

project_idinteger required

Project ID

environment_idinteger required

Environment ID

Query parameters

deployment_idinteger nullable

Only return containers belonging to this deployment. Omit to list containers across every deployment the environment has ever had.

limitinteger nullable

Maximum number of replaced container rows to return, most recently replaced first (default 20, max 100). Every currently-running container is always included and does not count against this limit — it only bounds how much historical (replaced-by-redeploy) context comes back alongside them.

Response

Containers that have run for this environment: every currently-running one first (uncapped), then the newest replaced ones up to limit

total_countinteger required

Total number of container rows matching the filter, before limit was applied — lets the client show "20 of 627".

Example response

{
  "containers": [
    {
      "deleted_at": "2025-10-12T12:15:47.609192Z",
      "deployed_at": "2025-10-12T12:15:47.609192Z",
      "finished_at": "2025-10-12T12:15:47.609192Z"
    }
  ]
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status