release_get_releases
Retrieve and filter Azure DevOps project releases by ID, status, environment, creation time, and more using customizable query parameters for precise results.
Instructions
Retrieves a list of releases for a given project.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
artifactTypeId | No | Filter releases by artifact type ID | |
artifactVersionId | No | Filter releases by artifact version ID | |
continuationToken | No | Continuation token for pagination | |
createdBy | No | User ID or name who created the release | |
definitionEnvironmentId | No | ID of the definition environment to filter releases | |
definitionId | No | ID of the release definition to filter releases | |
environmentStatusFilter | No | Environment status to filter releases | |
expand | No | Expand options for releases | None |
isDeleted | No | Whether to include deleted releases (default: false) | |
maxCreatedTime | No | Maximum created time for releases (default: now) | 2025-08-19T07:02:49.644Z |
minCreatedTime | No | Minimum created time for releases (default: 7 days ago) | 2025-08-12T07:02:49.644Z |
path | No | Path to filter releases | |
project | No | Project ID or name to get releases for | |
propertyFilters | No | Filter releases by properties | |
queryOrder | No | Order in which to return releases (default: Ascending) | Ascending |
releaseIdFilter | No | Filter by specific release IDs | |
searchText | No | Search text to filter releases | |
sourceBranchFilter | No | Filter releases by source branch | |
sourceId | No | Filter releases by artifact source ID | |
statusFilter | No | Status of the releases to filter (default: Active) | Active |
tagFilter | No | Filter releases by tags | |
top | No | Number of releases to return |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"artifactTypeId": {
"description": "Filter releases by artifact type ID",
"type": "string"
},
"artifactVersionId": {
"description": "Filter releases by artifact version ID",
"type": "string"
},
"continuationToken": {
"description": "Continuation token for pagination",
"type": "number"
},
"createdBy": {
"description": "User ID or name who created the release",
"type": "string"
},
"definitionEnvironmentId": {
"description": "ID of the definition environment to filter releases",
"type": "number"
},
"definitionId": {
"description": "ID of the release definition to filter releases",
"type": "number"
},
"environmentStatusFilter": {
"description": "Environment status to filter releases",
"type": "number"
},
"expand": {
"default": "None",
"description": "Expand options for releases",
"enum": [
"None",
"Environments",
"Artifacts",
"Approvals",
"ManualInterventions",
"Variables",
"Tags"
],
"type": "string"
},
"isDeleted": {
"default": false,
"description": "Whether to include deleted releases (default: false)",
"type": "boolean"
},
"maxCreatedTime": {
"default": "2025-08-19T07:02:49.644Z",
"description": "Maximum created time for releases (default: now)",
"format": "date-time",
"type": "string"
},
"minCreatedTime": {
"default": "2025-08-12T07:02:49.644Z",
"description": "Minimum created time for releases (default: 7 days ago)",
"format": "date-time",
"type": "string"
},
"path": {
"description": "Path to filter releases",
"type": "string"
},
"project": {
"description": "Project ID or name to get releases for",
"type": "string"
},
"propertyFilters": {
"description": "Filter releases by properties",
"items": {
"type": "string"
},
"type": "array"
},
"queryOrder": {
"default": "Ascending",
"description": "Order in which to return releases (default: Ascending)",
"enum": [
"Descending",
"Ascending"
],
"type": "string"
},
"releaseIdFilter": {
"description": "Filter by specific release IDs",
"items": {
"type": "number"
},
"type": "array"
},
"searchText": {
"description": "Search text to filter releases",
"type": "string"
},
"sourceBranchFilter": {
"description": "Filter releases by source branch",
"type": "string"
},
"sourceId": {
"description": "Filter releases by artifact source ID",
"type": "string"
},
"statusFilter": {
"default": "Active",
"description": "Status of the releases to filter (default: Active)",
"enum": [
"Undefined",
"Draft",
"Active",
"Abandoned"
],
"type": "string"
},
"tagFilter": {
"description": "Filter releases by tags",
"items": {
"type": "string"
},
"type": "array"
},
"top": {
"description": "Number of releases to return",
"type": "number"
}
},
"type": "object"
}