Atlassian

Atlassian Branch Restrictions API

The Branch Restrictions API from Atlassian — 2 operation(s) for branch restrictions.

Documentation GitHub OpenAPI

Business capability

Software Construction Management BC-4200.40

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /repositories/{workspace}/{repo_slug}/branch-restrictions List a repository's branch restrictions · Atlassian List Branch Restrictions #

Ask an LLM

“Which branch permissions are set on my Bitbucket repository?”

“Can I filter branch restrictions by kind, like push or delete, or by branch pattern?”

Tell an agent

List the branch restrictions on {workspace}/{repo_slug}.

Show {kind} restrictions in {workspace}/{repo_slug} matching branch pattern {pattern}.

POST /repositories/{workspace}/{repo_slug}/branch-restrictions Add a branch restriction rule · Atlassian Create A Branch Restriction Rule #

Ask an LLM

“How do I stop people from force-pushing to main?”

“Can I require approvals or completed tasks before merging into a branch?”

Tell an agent

Create a branch restriction in {workspace}/{repo_slug} allowing only users {users} to push.

Add a branch restriction rule to repository {repo_slug} in {workspace} for groups {groups}.

DELETE /repositories/{workspace}/{repo_slug}/branch-restrictions/{id} Delete a branch restriction rule · Atlassian Delete A Branch Restriction Rule #

Ask an LLM

“Can I lift a branch restriction so anyone can push again?”

“What's the way to remove one branch permission rule?”

Tell an agent destructive · confirm first

Delete branch restriction {id} from {workspace}/{repo_slug}.

Remove branch rule {id}.

GET /repositories/{workspace}/{repo_slug}/branch-restrictions/{id} Get one branch restriction rule · Atlassian Get A Branch Restriction Rule #

Ask an LLM

“What does a specific branch restriction rule enforce?”

“Can I look up one branch permission rule by its ID?”

Tell an agent

Get branch restriction {id} in {workspace}/{repo_slug}.

Show me the details of branch rule {id}.

PUT /repositories/{workspace}/{repo_slug}/branch-restrictions/{id} Change a branch restriction rule · Atlassian Update A Branch Restriction Rule #

Ask an LLM

“Can I add more users to an existing branch restriction?”

“Do fields I leave out when updating a branch rule stay unchanged?”

Tell an agent

Update branch restriction {id} in {workspace}/{repo_slug} to allow users {users}.

Change branch rule {id} to exempt groups {groups}.

Documentation

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-addon/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-webhooks/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-pullrequests/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-repositories/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-snippets/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-workspaces/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-users/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-analytics/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-audit/

https://developer.atlassian.com/cloud/confluence/connect-modules/

https://developer.atlassian.com/cloud/confluence/rest/v2/intro/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-body/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-states/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-group/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-inline-tasks

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-labels/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-long-running-task/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-relation/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-search/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-settings/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-space/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-template/

https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-user/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-announcement-banner/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-values--apps-/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-app-openapi

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-application-roles/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/

https://developer.atlassian.com/server/framework/atlassian-sdk/audit/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-avatars/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-classification-levels/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-components/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-settings/

https://developer.atlassian.com/cloud/jira/platform/getting-started-with-connect/

https://developer.atlassian.com/cloud/jira/platform/connect-api-migration/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-service-registry/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-dashboards/

https://developer.atlassian.com/cloud/jira/platform/data-security-policy-developer-guide/

https://developer.atlassian.com/platform/forge/events-reference/jira/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-expressions/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-filters/

https://developer.atlassian.com/cloud/jira/platform/forge/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-groups/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-group-and-user-picker/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-groups/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issues/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-links/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-security-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-types/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-type-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-type-screen-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-labels/

https://developer.atlassian.com/platform/marketplace/license-api-for-cloud-apps/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-license-metrics/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permissions/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-myself/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-notification-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-permission-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-priorities/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-categories/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-key-and-name-validation/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-resolutions/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-project-roles/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-screens/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-screen-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-security-level/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-server-info/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-statuses/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-status-categories/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-ui-modifications--apps-/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-avatars/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-versions/

https://developer.atlassian.com/server/jira/platform/webhooks/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflows/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-workflow-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/

https://developer.atlassian.com/cloud/admin/organization/rest/

https://developer.atlassian.com/cloud/admin/user-management/rest/

https://developer.atlassian.com/cloud/admin/user-provisioning/rest/

Specifications

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/openapi/atlassian-branch-restrictions-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-hook-events-paginated_hook_events-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-pull-requests-a_pullrequest_comment_task-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-repositories-account-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-snippets-account-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-teams-account-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-user-account-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-bitbucket-workspaces-account-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-content-body-async-content-body-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-content-states-async-id-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-group-group-array-with-links-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-inline-tasks-task-page-response-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-longtask-long-task-status-with-links-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-search-search-page-response-search-result-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-space-content-state-settings-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-template-blueprint-template-array-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-confluence-user-account-id-email-record-schema.json

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-schema/atlassian-admin-domain-page-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-hook-events-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-pull-requests-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-repositories-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-snippets-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-teams-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-user-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-bitbucket-workspaces-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-audit-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-content-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-content-body-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-content-states-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-group-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-inline-tasks-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-longtask-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-relation-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-search-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-settings-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-space-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-template-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-confluence-user-context.jsonld

https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/json-ld/atlassian-admin-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/atlassian:atlassian-branch-restrictions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Atlassian Branch Restrictions API
  version: '2.0'
  contact:
    name: Bitbucket Support
    url: https://support.atlassian.com/bitbucket-cloud/
    email: support@bitbucket.org
  termsOfService: https://www.atlassian.com/legal/customer-agreement
  description: 'Operations tagged Branch Restrictions across 2 of this provider''s published API definitions: bitbucket-openapi-original.yml, bitbucket-swagger.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.bitbucket.org/2.0
tags:


# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/atlassian/refs/heads/main/openapi/atlassian-branch-restrictions-api-openapi.yml