MicrosoftDocs / vsts-rest-api-specs

MIT License
158 stars 114 forks source link

Documentation incomplete for Pipelines - Create #655

Open mk0sojo opened 4 months ago

mk0sojo commented 4 months ago

The payload defined here seems incomplete and is missing examples. If I just use the documentation I will end up with:

{
    "name": "My Name",
    "folder": "\\A Folder",
    "configuration": {
        "type": "yaml"
    }
}

This result in an error: "Value cannot be null.\r\nParameter name: Path" so a path parameter is missing somewhere, but it is not documented here. Some searching stackoverflow seems to indicate this is how the payload should look:

{
  "folder": "\\A Folder",
  "name": "My Name",
  "configuration": {
    "type": "yaml",
    "path": "/azure-pipelines.yml",
    "repository": {
      "id": "guid-of-repo-id",
      "name": "my-repo",
      "type": "azureReposGit"
    }
  }
}

Are these extra parameters documented somewhere and are therre more (e.g. can I specify the branch?)


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.