Bitbucket

Bitbucket Commits API

These are the repository's commits. They are paginated and returned in reverse chronological order, similar to the output of git log.

Documentation GitHub OpenAPI

Business capability

Software Construction Management BC-4200.40

Operations 25

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}/commit/{commit} Get a commit · Get a commit #

Ask an LLM

“Who authored this commit and what was its message?”

“Can I look up a single commit by hash?”

Tell an agent

Get commit {commit} in {workspace}/{repo_slug}.

Show the author and message of commit {commit}.

DELETE /repositories/{workspace}/{repo_slug}/commit/{commit}/approve Withdraw my approval of a commit · Unapprove a commit #

Ask an LLM

“How do I take back my approval on a commit?”

“Can I unapprove a commit I signed off by mistake?”

Tell an agent destructive · confirm first

Unapprove commit {commit} in {workspace}/{repo_slug}.

Withdraw my approval from commit {commit}.

POST /repositories/{workspace}/{repo_slug}/commit/{commit}/approve Approve a commit · Approve a commit #

Ask an LLM

“Can I sign off on an individual commit?”

“How do I add my approval to a commit?”

Tell an agent

Approve commit {commit} in {workspace}/{repo_slug}.

Add my approval to commit {commit}.

GET /repositories/{workspace}/{repo_slug}/commit/{commit}/comments List comments on a commit · List a commit's comments #

Ask an LLM

“What have people said about this commit, inline and general?”

“Can I sort a commit's comments newest first?”

Tell an agent

List comments on commit {commit} in {workspace}/{repo_slug}.

Show comments on {commit} sorted by {sort}.

POST /repositories/{workspace}/{repo_slug}/commit/{commit}/comments Comment on a commit · Create comment for a commit #

Ask an LLM

“How do I leave a comment on a commit?”

“Can I reply to an existing comment thread on a commit?”

Tell an agent

Post a comment on commit {commit} in {workspace}/{repo_slug}.

Reply to the discussion on commit {commit}.

DELETE /repositories/{workspace}/{repo_slug}/commit/{commit}/comments/{comment_id} Delete a commit comment · Delete a commit comment #

Ask an LLM

“How do I delete a comment I left on a commit?”

“What happens to replies when a commit comment is deleted?”

Tell an agent destructive · confirm first

Delete comment {comment_id} on commit {commit} in {workspace}/{repo_slug}.

Remove my commit comment {comment_id}.

GET /repositories/{workspace}/{repo_slug}/commit/{commit}/comments/{comment_id} Get a commit comment · Get a commit comment #

Ask an LLM

“Can I fetch one comment on a commit by id?”

“Who wrote a particular commit comment and when?”

Tell an agent

Get comment {comment_id} on commit {commit} in {workspace}/{repo_slug}.

Show commit comment {comment_id}.

PUT /repositories/{workspace}/{repo_slug}/commit/{commit}/comments/{comment_id} Edit a commit comment · Update a commit comment #

Ask an LLM

“How do I fix a typo in a comment I left on a commit?”

“Can I edit the text of an existing commit comment?”

Tell an agent

Edit comment {comment_id} on commit {commit} in {workspace}/{repo_slug}.

Update the text of my commit comment {comment_id}.

GET /repositories/{workspace}/{repo_slug}/commit/{commit}/reports List code insight reports on a commit · List reports #

Ask an LLM

“Which code insight reports have been posted on this commit?”

“Can I see all the security and test reports linked to a commit?”

Tell an agent

List the reports on commit {commit} in {workspace}/{repo_slug}.

Show every code insight report attached to commit {commit}.

PUT /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId} Publish a code insight report to a commit · Create or update a report #

Ask an LLM

“How do I post my scanner's results to a commit as a code insight report?”

“Can I update a report I already uploaded by reusing the same report ID?”

Tell an agent

Create report {reportId} titled {title} on commit {commit} in {workspace}/{repo_slug}.

Upload report {reportId} for commit {commit} with result {result} and details {details}.

GET /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId} Get a code insight report on a commit · Get a report #

Ask an LLM

“What did one specific code insight report on my commit conclude?”

“Can I fetch a single commit report by its ID to check its result?”

Tell an agent

Get report {reportId} on commit {commit} in {workspace}/{repo_slug}.

Show the result of code insight report {reportId} for commit {commit}.

DELETE /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId} Delete a code insight report from a commit · Delete a report #

Ask an LLM

“How do I remove a code insight report that was posted on a commit by mistake?”

“Does deleting a commit report also remove its annotations?”

Tell an agent destructive · confirm first

Delete report {reportId} from commit {commit} in {workspace}/{repo_slug}.

Remove code insight report {reportId} on commit {commit}.

GET /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId}/annotations List annotations in a commit report · List annotations #

Ask an LLM

“Which individual findings are listed in a code insight report?”

“Can I page through all annotations a report flagged on a commit?”

Tell an agent

List annotations for report {reportId} on commit {commit} in {workspace}/{repo_slug}.

Show every finding in code insight report {reportId} of commit {commit}.

POST /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId}/annotations Upload many annotations to a report at once · Bulk create or update annotations #

Ask an LLM

“How do I attach a batch of vulnerability findings to a report in one call?”

“Can I bulk upload line-level annotations for a code insight report?”

Tell an agent

Bulk upload annotations to report {reportId} on commit {commit} in {workspace}/{repo_slug}.

Push a batch of findings into code insight report {reportId} for commit {commit}.

GET /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId}/annotations/{annotationId} Get one annotation from a commit report · Get an annotation #

Ask an LLM

“What are the details of one specific finding in a code insight report?”

“Can I fetch a single annotation by its ID?”

Tell an agent

Get annotation {annotationId} in report {reportId} on commit {commit}, repo {workspace}/{repo_slug}.

Show finding {annotationId} from code insight report {reportId}.

PUT /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId}/annotations/{annotationId} Create or update a single report annotation · Create or update an annotation #

Ask an LLM

“How do I flag one line of code as a finding in a code insight report?”

“Can I set the severity and file path on an individual annotation?”

Tell an agent

Create annotation {annotationId} in report {reportId} on commit {commit} in {workspace}/{repo_slug} for file {path} line {line}.

Set annotation {annotationId} on report {reportId} to severity {severity} with summary {summary}.

DELETE /repositories/{workspace}/{repo_slug}/commit/{commit}/reports/{reportId}/annotations/{annotationId} Delete one annotation from a commit report · Delete an annotation #

Ask an LLM

“How do I remove a single false-positive finding from a report?”

“Can I delete one annotation without deleting the whole report?”

Tell an agent destructive · confirm first

Delete annotation {annotationId} from report {reportId} on commit {commit} in {workspace}/{repo_slug}.

Remove finding {annotationId} from code insight report {reportId}.

GET /repositories/{workspace}/{repo_slug}/commits List a repository's commits · List commits #

Ask an LLM

“What are the latest commits in my repo, like git log?”

“Can I page through a repository's full commit history?”

Tell an agent

List commits in {workspace}/{repo_slug}.

Show the recent commit log for {repo_slug}.

POST /repositories/{workspace}/{repo_slug}/commits List commits with include and exclude in the body · List commits with include/exclude #

Ask an LLM

“My include/exclude list is too long for the URL, can I send it in a request body?”

“Which commits are on one set of branches but not another, using a POST body?”

Tell an agent

List commits in {workspace}/{repo_slug} with include and exclude refs sent in the body.

Query the commit log of {repo_slug} using a long include/exclude list.

GET /repositories/{workspace}/{repo_slug}/commits/{revision} List commits reachable from a revision · List commits for revision #

Ask an LLM

“What commits lead up to a particular branch or hash?”

“Can I see the history of a single branch only?”

Tell an agent

List commits reachable from {revision} in {workspace}/{repo_slug}.

Show the commit log of branch {revision}.

POST /repositories/{workspace}/{repo_slug}/commits/{revision} List a revision's commits with body filters · List commits for revision using include/exclude #

Ask an LLM

“Can I filter a revision's history with a long exclude list in the body?”

“Which commits from a branch are not in several other branches?”

Tell an agent

List commits from {revision} in {workspace}/{repo_slug} with include/exclude in the request body.

Query history of {revision} excluding many refs via a POST body.

GET /repositories/{workspace}/{repo_slug}/diff/{spec} Get a raw diff between commits · Compare two commits #

Ask an LLM

“What changed between two commits, as a git-style diff?”

“Can I ignore whitespace when diffing two revisions?”

Tell an agent

Show the raw diff for {spec} in {workspace}/{repo_slug}.

Diff {spec} restricted to {path}, ignoring whitespace {ignore_whitespace}.

GET /repositories/{workspace}/{repo_slug}/diffstat/{spec} Summarize lines changed between commits · Compare two commit diff stats #

Ask an LLM

“How many lines were added and removed per file between two commits?”

“Which files were modified, added or renamed in a change?”

Tell an agent

Show the diffstat for {spec} in {workspace}/{repo_slug}.

Count lines changed per file for {spec} under {path}.

GET /repositories/{workspace}/{repo_slug}/merge-base/{revspec} Find the common ancestor of two commits · Get the common ancestor between two commits #

Ask an LLM

“Where did these two branches diverge?”

“What is the merge base of two commits?”

Tell an agent

Find the merge base for {revspec} in {workspace}/{repo_slug}.

Get the best common ancestor of {revspec}.

GET /repositories/{workspace}/{repo_slug}/patch/{spec} Get a patch series for commits · Get a patch for two commits #

Ask an LLM

“Can I export a commit as a patch file I can apply elsewhere?”

“Is there a git format-patch style output for a range of commits?”

Tell an agent

Get the patch for {spec} in {workspace}/{repo_slug}.

Export {spec} as an applyable patch series.

Bitbucket Commits API

Operations 25

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