Skip to main content
POST
deploy.deployment.cancel

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string
required

Required: this capability has an external effect.

Maximum string length: 255
Pramaan-Account
string

Optional. One of your account ids (GET /v1/accounts): run on that account, whatever your routing rules say. The response header X-Pramaan-Account names the account that ran.

Pramaan-End-User
string

Optional. Your own tag for your end user: a sticky: end_user rule keeps them on the account that first served them.

Maximum string length: 256
Pramaan-End-User-Group
string

Optional. Your end user's group, matched by rules with endUserGroup.

Maximum string length: 64

Body

application/json
serviceId
string
required

Parent service identifier.

Pattern: ^[A-Za-z0-9_-]{1,100}$
id
string
required

Deployment identifier in this service.

Pattern: ^[A-Za-z0-9_-]{1,100}$
confirm
boolean
required

Explicitly approve this change, including removal or replacement of existing configuration.

Response

The result

id
string
required

The deployment's id. Pass it to deploy.deployment.get or deploy.deployment.promote.

url
string

The deployment's own address.

state
enum<string>

Build and serving state.

Available options:
queued,
initializing,
building,
ready,
error,
canceled,
blocked,
deleted
environment
string

"production", "preview", or a custom environment name.

createdAt
string

When it was created, ISO 8601.

readyAt
string

When it became ready, ISO 8601.

branch
string

Git branch it was built from.

commitSha
string

Git commit it was built from.

errorCode
string

Short machine code when the build failed.