> 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/bitbucket-settings-bitbucket.md).

# Bitbucket settings (bitbucket:)

bitbucket: configures one or more Bitbucket Cloud workspaces. The settings below cover connection and auth, which workspaces/repos to include or exclude, and, if you also run work-metrics, the local git-clone tuning it uses to classify commits, since Bitbucket has no blame or PR-diff API of its own.

<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>email</td><td>No</td><td>-</td><td>Atlassian account email (required for basic auth). Omit for Hivel-managed credentials</td></tr><tr><td>token</td><td>Yes (self-hosted)</td><td>-</td><td>Bitbucket repository access token. Omit for Hivel-managed credentials - see Hivel-managed credentials below</td></tr><tr><td>url</td><td>No</td><td>https://api.bitbucket.org/2.0</td><td>Override for Bitbucket Server</td></tr><tr><td>earliest_data_date</td><td>Yes</td><td>-</td><td>YYYY-MM-DD</td></tr><tr><td>include_workspaces</td><td>No</td><td>all accessible</td><td>Workspace slugs to sync</td></tr><tr><td>exclude_workspaces</td><td>No</td><td>-</td><td>Workspace slugs to skip</td></tr><tr><td>include_repos</td><td>No</td><td>all</td><td>Repo slugs to sync</td></tr><tr><td>exclude_repos</td><td>No</td><td>-</td><td>Repo slugs to skip</td></tr><tr><td>extra_branches</td><td>No</td><td>-</td><td>Additional branches to fetch</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</td></tr><tr><td>exclude_commit_patterns</td><td>No</td><td>-</td><td>Glob patterns for 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</td></tr><tr><td>exclude_pr_target_branches</td><td>No</td><td>-</td><td>Glob patterns for PR target branch</td></tr><tr><td>exclude_file_paths</td><td>No</td><td>-</td><td>Glob patterns for file paths in PRs</td></tr><tr><td>redact_names_and_urls</td><td>No</td><td>false</td><td>Redact names and URLs</td></tr><tr><td>strip_text_content</td><td>No</td><td>false</td><td>Strip all text content</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; Bitbucket Cloud has no blame REST API either, 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>

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

{% column %}

{% endcolumn %}

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