BuildDefinitionReference

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-azure-pipelines/json-schema/microsoft-azure-pipelines-build-definition-reference-schema.json",
  "title": "BuildDefinitionReference",
  "description": "Reference to a build definition containing its identification, folder path, queue status, and type.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-azure-pipelines-build-definitions-api-openapi.yml#/components/schemas/BuildDefinitionReference",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Build definition ID"
    },
    "name": {
      "type": "string",
      "description": "Build definition name"
    },
    "path": {
      "type": "string",
      "description": "Folder path of the definition"
    },
    "revision": {
      "type": "integer",
      "description": "Current revision number"
    },
    "type": {
      "type": "string",
      "description": "Definition type",
      "enum": [
        "xaml",
        "build"
      ]
    },
    "queueStatus": {
      "type": "string",
      "description": "Whether builds can be queued against this definition",
      "enum": [
        "enabled",
        "paused",
        "disabled"
      ]
    },
    "createdDate": {
      "type": "string",
      "format": "date-time",
      "description": "Date the definition was created"
    },
    "project": {
      "$ref": "#/$defs/TeamProjectReference"
    },
    "uri": {
      "type": "string",
      "description": "Definition URI"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "REST API URL for this definition"
    }
  },
  "$defs": {
    "TeamProjectReference": {
      "type": "object",
      "description": "Shallow reference to a team project",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "Project GUID identifier"
        },
        "name": {
          "type": "string",
          "description": "Project name"
        },
        "description": {
          "type": "string",
          "description": "Project description"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "REST API URL for the project"
        },
        "state": {
          "type": "string",
          "description": "Project state",
          "enum": [
            "deleting",
            "new",
            "wellFormed",
            "createPending",
            "all",
            "unchanged",
            "deleted"
          ]
        },
        "visibility": {
          "type": "string",
          "description": "Project visibility",
          "enum": [
            "private",
            "public"
          ]
        }
      }
    }
  }
}