Atlassian Repositories API

The Repositories API from Atlassian — 27 operation(s) for repositories.

Documentation GitHub OpenAPI

Business capability

Software Construction Management BC-4200.40

Operations 30

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 List all public Bitbucket repositories · Atlassian List Public Repositories #

Ask an LLM

“What public repositories exist across all of Bitbucket?”

“Can I see only public repos created after a certain date?”

Tell an agent

List public repositories created on or after {after}.

Search all public repos matching {q}, sorted by {sort}.

GET /repositories/{workspace} List the repositories in a workspace · Atlassian List Repositories In A Workspace #

Ask an LLM

“Which repositories does my team's workspace own?”

“Can I list only the workspace repos where I'm a contributor?”

Tell an agent

List every repository in workspace {workspace}.

Show repos in {workspace} where my role is {role}.

DELETE /repositories/{workspace}/{repo_slug} Delete a repository permanently · Atlassian Delete A Repository #

Ask an LLM

“Does deleting a repository also remove its forks?”

“Can I undo it after a repo is deleted?”

Tell an agent destructive · confirm first

Delete repository {repo_slug} from workspace {workspace}.

Permanently remove {workspace}/{repo_slug} and leave a redirect to {redirect_to}.

GET /repositories/{workspace}/{repo_slug} Get a repository's details · Atlassian Get A Repository #

Ask an LLM

“What is the main branch, language and privacy setting of a specific repo?”

“Is a given Bitbucket repository private or public?”

Tell an agent

Show repository {repo_slug} in workspace {workspace}.

Get the details of {workspace}/{repo_slug}.

POST /repositories/{workspace}/{repo_slug} Create a new repository · Atlassian Create A Repository #

Ask an LLM

“How do I create a new Bitbucket repository under a project?”

“Can I make a brand-new repo private from the start?”

Tell an agent

Create a new repository {repo_slug} in workspace {workspace}.

Create repo {repo_slug} in {workspace} under project {project} with private set to {is_private}.

PUT /repositories/{workspace}/{repo_slug} Update a repository's settings · Atlassian Update A Repository #

Ask an LLM

“How do I rename a repository or change its description?”

“Can I change who is allowed to fork an existing repo?”

Tell an agent

Change the description of {workspace}/{repo_slug} to {description}.

Set the fork policy of existing repo {repo_slug} in {workspace} to {fork_policy}.

GET /repositories/{workspace}/{repo_slug}/forks List the forks of a repository · Atlassian List Repository Forks #

Ask an LLM

“Who has forked a particular repository?”

“How many forks does a repo have, and can I filter them?”

Tell an agent

List the forks of {workspace}/{repo_slug}.

Show forks of {repo_slug} in {workspace} matching {q}.

POST /repositories/{workspace}/{repo_slug}/forks Fork a repository · Atlassian Fork A Repository #

Ask an LLM

“How do I fork a repo into a different workspace?”

“Can I give my fork a different name than the original?”

Tell an agent

Fork {workspace}/{repo_slug}.

Fork repo {repo_slug} from {workspace} into {owner} with the name {name}.

GET /repositories/{workspace}/{repo_slug}/override-settings Check which repo settings inherit from the project · Atlassian Retrieve The Inheritance State For Repository Settings #

Ask an LLM

“Is a repository inheriting its settings from the project or overriding them?”

“Which settings on a repo are overridden rather than inherited?”

Tell an agent

Show the settings inheritance state for {workspace}/{repo_slug}.

Check whether repo {repo_slug} in {workspace} overrides its project settings.

PUT /repositories/{workspace}/{repo_slug}/override-settings Set whether repo settings inherit from the project · Atlassian Set The Inheritance State For Repository Settings #

Ask an LLM

“Can I make a repository go back to inheriting its project's settings?”

“How do I switch a repo to override inherited settings?”

Tell an agent

Update the settings inheritance state for {workspace}/{repo_slug}.

Change repo {repo_slug} in {workspace} to override inherited project settings.

GET /repositories/{workspace}/{repo_slug}/permissions-config/groups List group permissions on a repository · Atlassian List Explicit Group Permissions For A Repository #

Ask an LLM

“Which groups have explicit access to a repository?”

“What permission level does each group hold on a repo?”

Tell an agent

List the group permissions on {workspace}/{repo_slug}.

Show every group with explicit access to repo {repo_slug} in {workspace}.

DELETE /repositories/{workspace}/{repo_slug}/permissions-config/groups/{group_slug} Remove a group's access to a repository · Atlassian Delete An Explicit Group Permission For A Repository #

Ask an LLM

“How do I revoke a group's explicit access to a repo?”

“Can I take a group off a repository's permission list?”

Tell an agent destructive · confirm first

Remove group {group_slug}'s permission from {workspace}/{repo_slug}.

Revoke group {group_slug}'s explicit access to repo {repo_slug} in {workspace}.

GET /repositories/{workspace}/{repo_slug}/permissions-config/groups/{group_slug} Get one group's permission on a repository · Atlassian Get An Explicit Group Permission For A Repository #

Ask an LLM

“Does a specific group have admin, write or read on a repo?”

“What access has one particular group been granted to a repository?”

Tell an agent

Get group {group_slug}'s permission on {workspace}/{repo_slug}.

Check what access group {group_slug} has to repo {repo_slug} in {workspace}.

PUT /repositories/{workspace}/{repo_slug}/permissions-config/groups/{group_slug} Grant or change a group's repository permission · Atlassian Update An Explicit Group Permission For A Repository #

Ask an LLM

“How do I give a group write access to a repository?”

“Can I change a group's repo access from read to admin?”

Tell an agent

Give group {group_slug} {permission} access to {workspace}/{repo_slug}.

Set group {group_slug}'s permission on repo {repo_slug} in {workspace} to {permission}.

GET /repositories/{workspace}/{repo_slug}/permissions-config/users List user permissions on a repository · Atlassian List Explicit User Permissions For A Repository #

Ask an LLM

“Which individual users have explicit access to a repository?”

“Who has been granted direct, per-user permissions on a repo?”

Tell an agent

List the user permissions on {workspace}/{repo_slug}.

Show every user with explicit access to repo {repo_slug} in {workspace}.

DELETE /repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user_id} Remove a user's access to a repository · Atlassian Delete An Explicit User Permission For A Repository #

Ask an LLM

“How do I revoke one person's explicit access to a repo?”

“Can I take an individual user off a repository's permissions?”

Tell an agent destructive · confirm first

Remove user {selected_user_id}'s permission from {workspace}/{repo_slug}.

Take the individual account {selected_user_id} off the user permission list of {repo_slug} in {workspace}.

GET /repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user_id} Get one user's permission on a repository · Atlassian Get An Explicit User Permission For A Repository #

Ask an LLM

“What access does a particular person have to a repo?”

“Does a specific user hold admin rights on a repository?”

Tell an agent

Get user {selected_user_id}'s permission on {workspace}/{repo_slug}.

Look up the direct per-user access level that account {selected_user_id} holds on {repo_slug} ({workspace}).

PUT /repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user_id} Grant or change a user's repository permission · Atlassian Update An Explicit User Permission For A Repository #

Ask an LLM

“How do I give one workspace member write access to a repo?”

“Can I give the workspace owner a different explicit permission on a repository?”

Tell an agent

Give user {selected_user_id} {permission} access to {workspace}/{repo_slug}.

Change the individual account {selected_user_id} to {permission} on {repo_slug} in the {workspace} workspace.

GET /repositories/{workspace}/{repo_slug}/watchers List the watchers of a repository · Atlassian List Repositories Watchers #

Ask an LLM

“Who is watching a given repository?”

“Which accounts get notified about activity on a repo?”

Tell an agent

List the watchers of {workspace}/{repo_slug}.

Show who watches repo {repo_slug} in {workspace}.

GET /user/permissions/repositories List the repositories I have explicit access to · Atlassian List Repository Permissions For A User #

Ask an LLM

“Which repositories do I have access to, and at what level?”

“What is my highest effective permission on each repo I can reach?”

Tell an agent

List my repository permissions.

Show the repos I have explicit access to matching {q}, sorted by {sort}.

GET /repositories/{workspace}/{repo_slug}/filehistory/{commit}/{path} List commits that modified a file #

GET /repositories/{workspace}/{repo_slug}/hooks List webhooks for a repository #

POST /repositories/{workspace}/{repo_slug}/hooks Create a webhook for a repository #

GET /repositories/{workspace}/{repo_slug}/hooks/{uid} Get a webhook for a repository #

PUT /repositories/{workspace}/{repo_slug}/hooks/{uid} Update a webhook for a repository #

DELETE /repositories/{workspace}/{repo_slug}/hooks/{uid} Delete a webhook for a repository #

GET /repositories/{workspace}/{repo_slug}/src Get the root directory of the main branch #

POST /repositories/{workspace}/{repo_slug}/src Create a commit by uploading a file #

GET /repositories/{workspace}/{repo_slug}/src/{commit}/{path} Get file or directory contents #

GET /user/workspaces/{workspace}/permissions/repositories List repository permissions in a workspace for a user #

Atlassian Repositories API

Operations 30

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification