Azure DevOps · Schema
ReleaseDefinition
A release pipeline definition
AgileCI/CDDeveloper ToolsDevOpsProject ManagementVersion Control
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | Unique numeric identifier of the definition |
| name | string | Display name of the release definition |
| path | string | Folder path for the definition |
| description | string | Description of the release definition |
| revision | integer | Current revision number |
| createdOn | string | |
| modifiedOn | string | |
| createdBy | object | |
| modifiedBy | object | |
| isDeleted | boolean | Whether this definition has been deleted |
| environments | array | Environments (deployment stages) in the release pipeline |
| artifacts | array | Artifact sources used by this release definition |
| triggers | array | Triggers that automatically create releases |
| variables | object | Release-level variables |
| tags | array | |
| source | string | |
| url | string | |
| _links | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/microsoft-azure-devops/json-schema/microsoft-azure-devops-release-definition-schema.json",
"title": "ReleaseDefinition",
"description": "A release pipeline definition",
"x-generated": "2026-11-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/microsoft-azure-devops-release-definitions-api-openapi.yml#/components/schemas/ReleaseDefinition",
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Unique numeric identifier of the definition"
},
"name": {
"type": "string",
"description": "Display name of the release definition"
},
"path": {
"type": "string",
"description": "Folder path for the definition"
},
"description": {
"type": "string",
"description": "Description of the release definition"
},
"revision": {
"type": "integer",
"description": "Current revision number"
},
"createdOn": {
"type": "string",
"format": "date-time"
},
"modifiedOn": {
"type": "string",
"format": "date-time"
},
"createdBy": {
"$ref": "#/$defs/IdentityRef"
},
"modifiedBy": {
"$ref": "#/$defs/IdentityRef"
},
"isDeleted": {
"type": "boolean",
"description": "Whether this definition has been deleted"
},
"environments": {
"type": "array",
"description": "Environments (deployment stages) in the release pipeline",
"items": {
"$ref": "#/$defs/ReleaseDefinitionEnvironment"
}
},
"artifacts": {
"type": "array",
"description": "Artifact sources used by this release definition",
"items": {
"$ref": "#/$defs/Artifact"
}
},
"triggers": {
"type": "array",
"description": "Triggers that automatically create releases",
"items": {
"type": "object"
}
},
"variables": {
"type": "object",
"description": "Release-level variables",
"additionalProperties": {
"$ref": "#/$defs/ConfigurationVariableValue"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string",
"enum": [
"undefined",
"restApi",
"userInterface",
"ibiza",
"portalExtensionApi"
]
},
"url": {
"type": "string",
"format": "uri"
},
"_links": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"href": {
"type": "string",
"format": "uri"
}
}
}
}
},
"$defs": {
"Artifact": {
"type": "object",
"description": "An artifact used in a release",
"properties": {
"alias": {
"type": "string",
"description": "Alias for the artifact within the release definition"
},
"type": {
"type": "string",
"description": "Artifact type",
"enum": [
"build",
"jenkins",
"github",
"nuget",
"team",
"externaltfsbuild",
"git",
"tfvc"
]
},
"definitionReference": {
"type": "object",
"description": "Reference to the artifact source definition",
"additionalProperties": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"isPrimary": {
"type": "boolean",
"description": "Whether this is the primary artifact"
},
"isRetained": {
"type": "boolean",
"description": "Whether this artifact is retained"
},
"sourceId": {
"type": "string",
"description": "Source identifier for the artifact"
}
}
},
"ConfigurationVariableValue": {
"type": "object",
"description": "A variable value in a release definition or release",
"properties": {
"value": {
"type": "string",
"description": "The variable value"
},
"isSecret": {
"type": "boolean",
"description": "Whether the value is treated as a secret"
},
"allowOverride": {
"type": "boolean",
"description": "Whether the value can be overridden when creating a release"
}
}
},
"IdentityRef": {
"type": "object",
"description": "Reference to an Azure DevOps user identity",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"displayName": {
"type": "string"
},
"uniqueName": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"imageUrl": {
"type": "string",
"format": "uri"
},
"descriptor": {
"type": "string"
}
}
},
"ReleaseDefinitionEnvironment": {
"type": "object",
"description": "An environment definition within a release pipeline",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"description": "Name of the environment"
},
"rank": {
"type": "integer",
"description": "Sequence order of the environment in the pipeline"
},
"deployPhases": {
"type": "array",
"description": "Deployment phases in this environment",
"items": {
"type": "object"
}
},
"conditions": {
"type": "array",
"description": "Conditions that must be met before deploying to this environment",
"items": {
"type": "object"
}
},
"preDeployApprovals": {
"type": "object",
"description": "Pre-deployment approval configuration"
},
"postDeployApprovals": {
"type": "object",
"description": "Post-deployment approval configuration"
},
"environmentOptions": {
"type": "object",
"description": "Environment-level options"
},
"variables": {
"type": "object",
"description": "Environment-level variables",
"additionalProperties": {
"$ref": "#/$defs/ConfigurationVariableValue"
}
},
"demands": {
"type": "array",
"items": {
"type": "object"
}
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-azure-devops-release-definition"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.