list_deployments
List deployments, optionally filtered by project.
| Parameter | Type | Required | Description |
|---|---|---|---|
app | string | No | Name of the deployment. |
from | number | No | Gets the deployment created after this Date timestamp. (default: current time) |
limit | number | No | Maximum number of deployments to list from a request. |
projectId | string | No | Filter deployments from the given ID or name. |
projectIds | Array<string> | No | Filter deployments from the given project IDs. Cannot be used when projectId is specified. |
target | string | No | Filter deployments based on the environment. |
to | number | No | Gets the deployment created before this Date timestamp. (default: current time) |
users | string | No | Filter out deployments based on users who have created the deployment. |
since | number | No | Get Deployments created after this JavaScript timestamp. |
until | number | No | Get Deployments created before this JavaScript timestamp. |
state | string | No | Filter deployments based on their state (BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED, BLOCKED) |
rollbackCandidate | boolean | No | Filter deployments based on their rollback candidacy |
branch | string | No | Filter deployments based on the branch name |
sha | string | No | Filter deployments based on the SHA |
teamId | string | No | Team ID to use for this operation. |
slug | string | No | Team slug to use for this operation. Use instead of teamId. |
Sample prompt: "Show me deployments for my blog project"
If your connection exposes the smaller workflow tool list, use these parameters instead. Follow your connection's tool schema.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | string | Yes | - | The project ID to list deployments for. |
teamId | string | Yes | - | The team ID or slug. Use the team that owns the resource. |
since | number | No | - | Get deployments created after this timestamp. |
until | number | No | - | Get deployments created before this timestamp. |
Was this helpful?