Deploys

Search deployments across the tenant

Changed on
get/api/v1/deploys/search

Request

  • Base URL
    https://api.getcortexapp.com
  • URL
    https://api.getcortexapp.com/api/v1/deploys/search
  • Auth
    HTTP bearer

Query parameters

environmentsstring[]

Filter by environment names (exact match, any of)

typesstring[]

Filter by deploy types: DEPLOY, ROLLBACK, SCALE, RESTART

entityTagOrIdsstring[]

Filter to these entity tags or CIDs (any of)

timestampAfterstring date-time

Only deploys at or after this timestamp (UTC, e.g. 2026-06-22T00:00:00)

timestampBeforestring date-time

Only deploys at or before this timestamp (UTC, e.g. 2026-06-22T00:00:00)

pageSizeinteger required

Number of results to return per page, between 1 and 1000. Default 250.

pageinteger required

Page number to return, 0-indexed. Default 0.

Response

OK

pageinteger required

Current page number, 0-indexed

totalinteger required

Total number of results

totalPagesinteger required

Total number of pages

Example response

{
  "deployments": [
    {
      "url": "https://cortex.io"
    }
  ]
}

Changes