GET /v6/deployments

List deployments under the authenticated user or team. If a deployment hasn't finished uploading (is incomplete), the url property will have a value of null.

Servers

Query parameters

Name Type Required Description
projectId String No

Filter deployments from the given ID or name.

sha String No

Filter deployments based on the SHA

teamId String No

The Team identifier to perform the request on behalf of.

since Number No

Get Deployments created after this JavaScript timestamp.

state String No

Filter deployments based on their state (BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED)

from Number No

Gets the deployment created after this Date timestamp. (default: current time)

to Number No

Gets the deployment created before this Date timestamp. (default: current time)

rollbackCandidate Boolean No

Filter deployments based on their rollback candidacy

limit Number No

Maximum number of deployments to list from a request.

slug String No

The Team slug to perform the request on behalf of.

app String No

Name of the deployment.

until Number No

Get Deployments created before this JavaScript timestamp.

target String No

Filter deployments based on the environment.

branch String No

Filter deployments based on the branch name

users String No

Filter out deployments based on users who have created the deployment.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.