---
title: "Start Azure DevOps OAuth installation"
method: POST
path: "/api/v1/installations/start-azure-devops-oauth"
tags: ["Installations"]
---

# Start Azure DevOps OAuth installation

`POST /api/v1/installations/start-azure-devops-oauth`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v1/installations/start-azure-devops-oauth`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Creates an Azure DevOps OAuth authorization URL for connecting an Azure DevOps Services organization.

## Request body

- StartAzureDevOpsOAuthInput
  - `organizationId` string, required
  - `azureOrganizationUrl` string, uri, required: Azure DevOps Services organization URL, for example https://dev.azure.com/org
  - `azureDevOpsAppId` string: Optional ZeroPath-managed Azure DevOps OAuth app ID.
  - `tenantMode` 'COMMON' | 'ORGANIZATIONS' | 'TENANT': Microsoft Entra tenant selector used for Azure DevOps OAuth. TENANT requires tenantId.
  - `tenantId` string: Microsoft Entra tenant ID. Required when tenantMode is TENANT.
  - `redirectUri` string, uri: OAuth callback URL. Defaults to /api/azure-devops/oauth/callback.

## Response `200`

Azure DevOps OAuth authorization URL

- StartAzureDevOpsOAuthResponse
  - `url` string, uri, required: Microsoft Entra authorization URL for the Azure DevOps OAuth flow.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api-2.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api-2/revisions/ea6ae4b68cd3?raw)