Azure DevOps REST API - broken example and missing documentation in Configurations - Create

[ruijarimba]

The Merge strategy policy example is broken.

POST https://dev.azure.com/fabrikam/fabrikam-fiber-git/_apis/policy/configurations?api-version=7.0

{
  "isEnabled": true,
  "isBlocking": true,
  "type": {
    "id": "fa4e907d-c16b-4a4c-9dfa-4916e5d171ab"
  },
  "settings": {
    "useSquashMerge": true,
    "scope": [
      {
        "repositoryId": "1d1dad71-f27c-4370-810d-838ec41efd41",
        "refName": "refs/heads/master",
        "matchKind": "exact"
      }
    ]
  }
}

useSquashMerge setting doesn't work in Azure DevOps Services (see SO issue), allowSquash should be used instead.

Also, I had to do a Google search in order to find the right settings for the Merge strategy policy:

• useSquashMerge
• allowNoFastForward
• allowSquash
• allowRebase
• allowRebaseMerge

These settings should be properly documented in the page. It would be great if the sample request listed above could include these settings as well.

---

Document Details

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

• ID: b00da3af-835e-54a2-a9c0-40ae728b7dad
• Version Independent ID: f8e6967f-ce8d-08be-d84c-d422cbf0142c
• Content: Configurations - Create - REST API (Azure DevOps Policy)
• Content Source: docs-ref-autogen/7.0/policy/Configurations/Create.yml
• Service: azure-devops
• Sub-service: azure-devops-ref
• GitHub Login: @wnjenkin
• Microsoft Alias: whjenkin

[Kanahowl]

Thank you for your message, you helped me a lot.. didn't get why it wasn't working before. The keys were just not the right ones to use.