> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/hybrid-hivel-agent/5.-configuration-reference/azure-devops-settings-azure.md).

# Azure DevOps settings (azure:)

Azure DevOps is also a list, so multiple instances (e.g. Azure DevOps Services plus an on-prem Server) are supported side by side. The settings below cover connection and auth, whether you're pointing at cloud or on-prem (is\_server), which orgs/projects/repos to include or exclude, and, if you also run work-metrics, the local git-clone tuning it uses to classify commits and PRs.

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Required</strong></td><td><strong>Default</strong></td><td><strong>Description</strong></td></tr><tr><td>instance_slug</td><td>Yes</td><td>-</td><td>Unique name for this instance</td></tr><tr><td>token</td><td>Yes (self-hosted)</td><td>-</td><td>Azure DevOps Personal Access Token. Omit for Hivel-managed credentials - see Hivel-managed credentials below</td></tr><tr><td>url</td><td>No</td><td>https://dev.azure.com</td><td>Override - required when is_server: true (full collection URL, e.g. https://host/tfs/CollectionName)</td></tr><tr><td>is_server</td><td>No</td><td>false</td><td>Set for Azure DevOps Server (on-prem/TFS) instead of Azure DevOps Services (cloud)</td></tr><tr><td>api_version</td><td>No</td><td>7.1</td><td>Override the api-version sent on every request - older on-prem Server instances often pin 7.0</td></tr><tr><td>earliest_data_date</td><td>Yes</td><td>-</td><td>YYYY-MM-DD</td></tr><tr><td>organization</td><td>No</td><td>-</td><td>Default org for single-org PATs</td></tr><tr><td>include_organizations</td><td>No</td><td>all accessible</td><td>Organization names to sync - takes precedence over organization</td></tr><tr><td>include_projects</td><td>No</td><td>all</td><td>Project names to sync</td></tr><tr><td>exclude_projects</td><td>No</td><td>-</td><td>Project names to skip</td></tr><tr><td>include_repos</td><td>No</td><td>all</td><td>Repo names to sync</td></tr><tr><td>exclude_repos</td><td>No</td><td>-</td><td>Repo names to skip</td></tr><tr><td>extra_branches</td><td>No</td><td>-</td><td>Additional branch names to fetch for all repos</td></tr><tr><td>include_branches</td><td>No</td><td>-</td><td>Per-repo branch override map</td></tr><tr><td>concurrent_threads</td><td>No</td><td>5</td><td>Goroutines for concurrent repo fetching</td></tr><tr><td>skip_ssl_verification</td><td>No</td><td>false</td><td>Disable TLS verification (self-signed certs on Server)</td></tr><tr><td>exclude_commit_patterns</td><td>No</td><td>-</td><td>Glob patterns matched against commit messages to skip</td></tr><tr><td>exclude_pr_source_branches</td><td>No</td><td>-</td><td>Glob patterns for PR source branch to skip (e.g. dependabot/*)</td></tr><tr><td>exclude_pr_target_branches</td><td>No</td><td>-</td><td>Glob patterns for PR target branch to skip</td></tr><tr><td>exclude_teams</td><td>No</td><td>-</td><td>Glob patterns for team names to skip</td></tr><tr><td>redact_names_and_urls</td><td>No</td><td>false</td><td>Replace names and URLs with redacted-NNNN placeholders</td></tr><tr><td>strip_text_content</td><td>No</td><td>false</td><td>Strip all text (commit messages, PR titles, etc.)</td></tr><tr><td>clone_cache_dir</td><td>No</td><td>/var/hivel/repo_cache</td><td>`work-metrics` only - local repo cache root; Azure has no blame/PR-diff REST API, so classification clones instead</td></tr><tr><td>clone_mode</td><td>No</td><td>shallow-depth</td><td>`work-metrics` only - full, shallow-depth, or shallow-since</td></tr><tr><td>clone_depth</td><td>No</td><td>30</td><td>`work-metrics` only - commits to fetch when clone_mode: shallow-depth</td></tr><tr><td>clone_since_days</td><td>No</td><td>30</td><td>`work-metrics` only - days lookback when clone_mode: shallow-since</td></tr></tbody></table>

**Azure DevOps API used:** REST, api-version 7.1 by default. Both Azure DevOps Services (cloud) and Azure DevOps Server (on-prem/TFS) are supported.

**Multi-instance credentials** - use a different ${ENV\_VAR} per entry (same pattern as GitHub above):

```
azure:
  - instance_slug: azure-cloud
    token: ${AZ_CLOUD_TOKEN}
    organization: your-org
  - instance_slug: azure-onprem
    token: ${AZ_SERVER_TOKEN}
    is_server: true
    url: ${AZ_SERVER_URL}
    api_version: "7.0"
    skip_ssl_verification: true
```

{% columns %}
{% column %} <a href="/hybrid-hivel-agent/5.-configuration-reference/bitbucket-settings-bitbucket.md" class="button primary" data-icon="backward">Bitbucket settings</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/hybrid-hivel-agent/5.-configuration-reference/claudeotel-settings-claudeotel.md" class="button primary" data-icon="forward">claudeotel-settings</a>
{% endcolumn %}
{% endcolumns %}