List Revisions

List all revisions for a deployment.

GET /v2/deployments/{deployment_id}/revisions

List Revisions

cURL

curl --request GET \
  --url https://api.example.com/v2/deployments/{deployment_id}/revisions

200

{
  "resources": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "source_revision_config": {
        "repo_ref": "<string>",
        "langgraph_config_path": "<string>",
        "image_uri": "<string>",
        "source_tarball_path": "<string>",
        "repo_commit_sha": "<string>"
      }
    }
  ],
  "offset": 123
}

Path Parameters

deployment_id · string<uuid> · required

Query Parameters

limit · integer · default: 20

Maximum number of resources to return.

Required range: 1 <= x <= 100

offset · integer · default: 0

Pagination offset. Pass this value to subsequent requests to fetch the next page of resources.

Required range: x >= 0

status · string | null

Comma separated list of revision status (CREATING, QUEUED, AWAITING_BUILD, BUILDING, AWAITING_DEPLOY, DEPLOYING, CREATE_FAILED, BUILD_FAILED, DEPLOY_FAILED, DEPLOYED, SKIPPED, INTERRUPTED, UNKNOWN) fields to filter by.

remote_reconciled · boolean | null

Flag to filter by remote reconciled revisions.

Response

200

application/json

Successful Response

resources · Revision · object[] · required

Show child attributes

offset · integer · required

Pagination offset. Pass this value to subsequent requests to fetch the next page.