Skip to main content
POST
/
api
/
v1
/
installations
/
start-azure-devops-oauth
Start Azure DevOps OAuth installation
curl --request POST \
  --url https://zeropath.com/api/v1/installations/start-azure-devops-oauth \
  --header 'Content-Type: application/json' \
  --header 'X-ZeroPath-API-Token-Id: <api-key>' \
  --header 'X-ZeroPath-API-Token-Secret: <api-key>' \
  --data '
{
  "organizationId": "<string>",
  "azureOrganizationUrl": "<string>",
  "azureDevOpsAppId": "<string>",
  "tenantId": "<string>",
  "redirectUri": "<string>"
}
'
{
  "url": "<string>"
}

Authorizations

X-ZeroPath-API-Token-Id
string
header
required
X-ZeroPath-API-Token-Secret
string
header
required

Body

application/json
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
enum<string>

Microsoft Entra tenant selector used for Azure DevOps OAuth. TENANT requires tenantId.

Available options:
COMMON,
ORGANIZATIONS,
TENANT
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

Azure DevOps OAuth authorization URL

url
string<uri>
required

Microsoft Entra authorization URL for the Azure DevOps OAuth flow.