list_deployments
List deployments in an Octopus Deploy space with optional filters for projects, environments, tenants, channels, and task states to monitor deployment status and history.
Instructions
List deployments in a space
This tool lists deployments in a given space. The space name is required. When requesting latest deployment consider which deployment state the user is interested in (successful or all). Optional filters include: projects (array of project IDs), environments (array of environment IDs), tenants (array of tenant IDs), channels (array of channel IDs), taskState (one of: Canceled, Cancelling, Executing, Failed, Queued, Success, TimedOut), and take (number of results to return).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channels | No | ||
| environments | No | ||
| projects | No | ||
| skip | No | ||
| spaceName | Yes | ||
| take | No | ||
| taskState | No | ||
| tenants | No |
Input Schema (JSON Schema)
{
"properties": {
"channels": {
"items": {
"type": "string"
},
"type": "array"
},
"environments": {
"items": {
"type": "string"
},
"type": "array"
},
"projects": {
"items": {
"type": "string"
},
"type": "array"
},
"skip": {
"type": "number"
},
"spaceName": {
"type": "string"
},
"take": {
"type": "number"
},
"taskState": {
"enum": [
"Canceled",
"Cancelling",
"Executing",
"Failed",
"Queued",
"Success",
"TimedOut"
],
"type": "string"
},
"tenants": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"spaceName"
],
"type": "object"
}