Skip to main content
GET
List deployment history
Required permissions: deployment.read. Personal keys are capped by their owner’s current team role. See request conventions and automation workflows. MCP clients use the task-oriented tool catalogue.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1
Required range: 1 <= x <= 1000000
limit
integer
default:10
Required range: 1 <= x <= 100
environment
enum<string>
Available options:
production,
preview
targetEnvironment
string
Pattern: ^[a-z][a-z0-9-]{0,62}$
type
enum<string>
Available options:
app,
resource
state
enum<string>
Available options:
queued,
waiting_for_server,
preparing,
validating_credentials,
checking_server,
fetching_source,
resolving_secrets,
transferring,
building,
running_pre_deploy,
starting_candidate,
checking_health,
configuring_routing,
provisioning_tls,
checking_public_endpoint,
switching_traffic,
running_post_deploy,
cleaning_up,
succeeded,
succeeded_with_warnings,
skipped,
failed,
cancelled
trigger
enum<string>
Available options:
auto_deploy,
manual,
rollback
serverId
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
sort
enum<string>
default:newest
Available options:
newest,
oldest,
name_asc,
name_desc

Response

Deployment history and pagination metadata.

environments
string[]
required
deployments
object[]
required
pagination
object
required
localization
object
required
Last modified on September 5, 2026