list_deployments
List deployments as compact rows, filterable by server and status.
Lists deployments as compact rows: id, name, status, serverId, gitBranch, createdAt. Paginated server-side. Read-only.
This is the source of truth for deploymentId. Pass serverId to scope to one server, and filter by status (for example failed) when the user describes a deployment rather than naming it.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
organizationId | string | Yes | Organization to scope the request. From list_organizations. |
serverId | string | No | Filter to one server's deployments. From list_servers. |
status | string | No | Filter by deployment status (e.g. running, failed). |
limit | number | No | Max deployments to return (1–200, default 25). |
offset | number | No | Number of deployments to skip (default 0). |
Returns
A deployments array plus a pagination object with the effective limit, offset, total matches, and returned count.
Related
get_deployment: full details for one deploymentget_deployment_build_logs/get_deployment_runtime_logs: logs