Get host targets
get_host_targetsRead the machines an environment deploys to and the deployments rolled out to them. report picks it: host_targets (each host's status, agent version, OS and last heartbeat; the twin of ankra targets list and get) or deployments (each release rolled out, newest first, with how many hosts succeeded and failed; the twin of ankra deployments list and get). Pass host_target_id or deployment_id for one, with a deployment's per-host results. Needs pipelines.read; only this project's environments are read. A join token is never listed. Read-only: minting a join token and revoking a host are not offered here.
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": {
"report": "<report>"
},
"name": "get_host_targets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | deployments: rows to return, 1 to 100 (default 20). | |
| cursor | No | deployments: the next_cursor of the previous page. | |
| report | Yes | Which listing to read. | |
| environment | No | Only this environment's hosts or deployments. | |
| deployment_id | No | deployments: one deployment (UUID). | |
| repository_id | No | deployments: only this repository's (UUID). | |
| host_target_id | No | host_targets: one host target (UUID). |