List Bitbucket Server projects visible to the authenticated user. Returns project key, name, description, visibility and lock state. Paginated.

List GIT repositories, either all at server level (no filter) or scoped to one project. Each item: project key, slug, name, state. Paginated.

Get full details for a single repository: project key, slug, name, state, default branch, fork source, clone URLs and web link.

Create a new repository under an existing project. Defaults: empty repo with initial 'master' branch, private. Set 'forkFrom' to fork from another repo.

List branches in a repository. For each branch: name, latest commit, and how far it is behind/ahead of the default branch (when available). Paginated.

Get details for one branch: name, latest commit id and author, relation to default branch.

Create a new branch from a given start point (branch name or commit SHA).

Delete a branch from a repository. Refuses to delete the default branch.

List pull requests in a repository. Filter by state (OPEN default, MERGED, DECLINED), author, reviewer, or text match on title/description. Paginated. Note: projectKey must be the exact uppercase key (e.g. 'USDMF'), not lowercase.

Get full details for a single PR: state, branches (from/to), author, reviewers, participants, version, and web link.

Create a new PR from a source branch to a destination branch. 'reviewer' is optional (username). Returns the created PR with its id.

Update title/description/reviewers of a PR. Omitted fields are left unchanged. Returns the updated PR.

Merge an OPEN PR. Strategy: 'noFF' (default three-way merge), 'fastForward', 'squash', 'rebase', or a custom variant string. Returns the merged PR.

Decline an OPEN PR (closes it without merging). Returns the declined PR.

Approve a PR as the authenticated user. Idempotent — re-approving is a no-op.

Remove the authenticated user's approval from a PR.

List comments on a PR (including global and inline code comments). Each comment: id, text, author, state (OPEN/RESOLVED), anchored-to line/lineType, and web link. Paginated.

Add a comment on a PR. Inline code comments need 'anchoredTo' (file path + line number + lineType). Plain text goes in 'text'. Returns the created comment.

Edit the text of an existing comment. Returns the updated comment.

Delete a comment. Returns confirmation.

Mark a comment as resolved. Resolving a parent resolves the whole thread.

Get the full diff between two refs (commit SHA or branch name). 'until' defaults to the default branch. On this server the diff is reconstructed by walking /commits//diff along the branch lineage from until down to (but not including) from. Returns per-file entries with status, +N/−N counts and the unified diff body.

Get a per-file summary of the diff between two refs (commit SHA or branch name). 'until' defaults to the default branch. On this server it is reconstructed by walking /commits//diff along the branch lineage from until down to (but not including) from. Each entry: path, status, +N/−N counts, and a short preview (first ~400 chars of the file's diff).

Get the full unified diff for a PR (all changed files as one large diff text).

Get a per-file summary of what a PR changes: status, +N/−N counts, first hunk.

Get details for a single commit: message, author, date, parents, and relevant PRs. 'slug' can be a full SHA, short SHA, or 'HEAD'.

List commits on a branch in newest-to-oldest order. Each: short SHA, full SHA, message, author, date. 'branch' defaults to default branch. Paginated.

Get the raw diff introduced by a single commit (the changes the commit makes relative to its parent).

Get the parent commits of a commit (usually one; two for a merge commit).

List immediate children of a directory in a repo at a given ref (default branch or commit SHA). Each item: name, type (FILE/DIRECTORY), and path.

Read the full content of a file at a ref. Returns the text content as-is (no wrapping).

Fetch the raw bytes of a file at a ref and return as plain text. Use this to read files. Binary files will be base64-encoded.

Get metadata about a file: name, parent directory, and commit that last touched it. Use for existence checks and audit trails.

Create a new file at 'path' on 'branch' with 'content'. Optional 'message' is the commit message (default = 'Create '). Returns the new commit id and file path.

Replace the full content of an existing file on 'branch'. 'message' is the commit message (default = 'Update '). Returns the new commit id.

Remove a file from 'branch' with a commit. The commit message is 'Delete ' by default.

Search repositories across the server by name/description. Returns project key, slug, name, and description for each match.

Not available on this Bitbucket Server (v7.12.1). The code-search endpoint is disabled; use get_file / list_directory instead.

List build statuses for a commit (from CI providers reporting to Bitbucket). Each build: key, state (SUCCESS/FAILED/RUNNING/QUEUED), and URL.

Read server-wide application properties (read-only; modifications require admin). Useful for confirming connectivity and server version.

Given a project folder (relative to CWD or absolute), find its .git directory, read git remote get-url origin, and parse out the Bitbucket project key + repo slug. When the folder isn't itself a git repo, it searches the folder's children (up to 2 levels) for a git repo. If more than one is found, it lists the candidates and you must re-invoke with one of them. Returns { projectKey, repoSlug, remoteUrl, resolvedDir }.