# Microsoft Azure DevOps Server version tags

Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fdeveloper-portal%2Fapis%2Fversion-tags%2Fmicrosoft-azure-devops-server-version-tags.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fdeveloper-portal%2Fapis%2Fversion-tags%2Fmicrosoft-azure-devops-server-version-tags.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

Tell Coralogix when a new build ships, straight from your Azure DevOps Server pipeline. A service hook on build completion creates a version tag, which is what version benchmark reports compare behavior across.

## What you need [​](#what-you-need- "Direct link to what-you-need-")

* Access to your Azure DevOps Server team project's settings.
* A personal or team [API key](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md) with the `CICDIntegration` preset. Presets pick up new permissions automatically; individual permissions have to be maintained by hand.
* The Azure DevOps version tags endpoint for your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md). Use the domain selector at the top of this page to resolve it:
  <!-- -->
  https\://api./api/v1/external/tfs?application=YOUR\_APPLICATION\_NAME\&subsystem=YOUR\_SUBSYSTEM\_NAME\&name=YOUR\_TAG\_NAME

| Preset          | Actions                                                                                                   | Grants                                                                                             |
| --------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| CICDIntegration | `VERSION-BENCHMARK-TAGS:READ`<br />`VERSION-BENCHMARKS-REPORTS:READ`<br />`VERSION-BENCHMARK-TAGS:UPDATE` | View version benchmark tags<br />View version benchmark reports<br />Modify version benchmark tags |

## Create the service hook [​](#create-the-service-hook- "Direct link to create-the-service-hook-")

1

<!-- -->

.

Open service hooks

Sign in to Azure DevOps Server, select your team project, then **Settings**, then **Service hooks**.

2

<!-- -->

.

Add a web hook

Select **Add new service hooks**, then **Web Hooks**.

3

<!-- -->

.

Trigger on completed builds

Select **Build Completed** as the trigger, set **Build status** to **Succeeded**, and select **Next**. Add any further filters you want.

4

<!-- -->

.

Point it at Coralogix

Enter the Azure DevOps version tags endpoint for your domain, with the query parameters below.

| Parameter     | What to enter                                                                                                                                                                             |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `application` | Required. Must match your logs [application name](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names.md) exactly                  |
| `subsystem`   | Must match your logs [subsystem name](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names.md). Separate multiple names with commas |

5

<!-- -->

.

Authorize the request

Add a header carrying your API key, then select **Finish**.

```
Authorization: Bearer <cx_api_key>
```

## Related resources[​](#related-resources "Direct link to Related resources")

[Coralogix endpoints](https://coralogix.com/docs/integrations/coralogix-endpoints.md)[API keys](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md)[Application and subsystem names](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names.md)