List Workload Deployments
list_deploymentsA workload's deployments: its per-location rollout status. This is the PRIMARY readiness check after create_workload/update_workload: pass waitSeconds to wait on the server until ready, then report the canonical endpoint as the public URL, never a URL built by hand. Without location: every location with readiness, endpoints, and the canonical URL. Each location also names its running replicas, the --replica value for cpln workload exec, cpln workload connect, cpln cp, and cpln port-forward. For cron workloads, per-execution run history lives in status.jobExecutions of the per-location detail. A location that reports an error: diagnose_workload.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"gvc": "<gvc>",
"workload": "<workload>"
},
"name": "list_deployments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gvc | Yes | GVC name. | |
| org | No | Organization slug. | |
| location | No | OPTIONAL. A workload has one deployment per location it runs in. Omit for readiness across ALL locations plus the canonical public URL. Pass a location (e.g. "aws-us-east-1") for that single deployment's full detail — version chain, per-container readiness, and full JSON. | |
| workload | Yes | Workload whose deployments to inspect. | |
| waitSeconds | No | Seconds to wait on the server until every listed location is ready, 0 to 45. The call returns as soon as it is, or with the latest state when the time runs out. Use this instead of calling again and again. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | The full result. Read this, not only the summary. | |
| details | No | ||
| summary | Yes | ||
| nextSteps | No |