Compare two commit diff stats

GET

/repositories/{workspace}/{repo_slug}/diffstat/{spec}

Produces a response in JSON format with a record for every path modified, including information on the type of the change and the number of lines added and removed.

Single commit spec

If the spec argument to this API is a single commit, the diff is produced against the first parent of the specified commit.

Two commit spec

Two commits separated by .. may be provided as the spec, e.g., 3a8b42..9ff173. When two commits are provided and the topic query parameter is true, this API produces a 2-way three dot diff. This is the diff between source commit and the merge base of the source commit and the destination commit. When the topic query param is false, a simple git-style diff is produced.

The two commits are interpreted as follows:

First commit: the commit containing the changes we wish to preview
Second commit: the commit representing the state to which we want to compare the first commit
Note: This is the opposite of the order used in git diff.

Authorizations

oauth2
repository
basic
api_key

Parameters

Path Parameters

repo_slug

required

string

This can either be the repository slug or the UUID of the repository, surrounded by curly-braces, for example: {repository UUID}.

spec

required

string

A commit SHA (e.g. 3a8b42) or a commit range using double dot notation (e.g. 3a8b42..9ff173).

workspace

required

string

This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example: {workspace UUID}.

Query Parameters

ignore_whitespace

boolean

Generate diffs that ignore whitespace

merge

boolean

This parameter is deprecated. The ‘topic’ parameter should be used instead. The ‘merge’ and ‘topic’ parameters cannot be both used at the same time.

If true, the source commit is merged into the destination commit, and then a diffstat from the destination to the merge result is returned. If false, a simple ‘two dot’ diffstat between the source and destination is returned. True if omitted.

path

string

Limit the diffstat to a particular file (this parameter can be repeated for multiple paths).

renames

boolean

Whether to perform rename detection, true if omitted.

topic

boolean

If true, returns 2-way ‘three-dot’ diff. This is a diff between the source commit and the merge base of the source commit and the destination commit. If false, a simple ‘two dot’ diff between the source and destination is returned.

Responses

200

The diff stats

application/json

Paginated Diff Stat

A paginated list of diffstats.

object

size

Total number of objects in the response. This is an optional element that is not provided in all responses, as it can be expensive to compute.

integer

page

Page number of the current results. This is an optional element that is not provided in all responses.

integer

>= 1

pagelen

Current number of objects on the existing page. The default value is 500 with 5000 being the maximum allowed value.

integer

>= 1

next

Link to the next page if it exists. The last page of a collection does not have this value. Use this link to navigate the result set and refrain from constructing your own URLs.

string format: uri

previous

Link to previous page if it exists. A collections first page does not have this value. This is an optional element that is not provided in all responses. Some result sets strictly support forward navigation and never provide previous links. Clients must anticipate that backwards navigation is not always available. Use this link to navigate the result set and refrain from constructing your own URLs.

string format: uri

values

Array<object>

0 unique items

Diff Stat

A diffstat object that includes a summary of changes made to a file between two commits.

object

type

required

string

status

string

Allowed values: added removed modified renamed

lines_added

integer

lines_removed

integer

old

Commit File

A file object, representing a file at a commit in a repository

object

type

required

string

path

The path in the repository

string

commit

object

type

required

string

hash

string

/[0-9a-f]{7,}?/

date

string format: date-time

author

object

type

required

string

raw

The raw author value from the repository. This may be the only value available if the author does not match a user in Bitbucket.

string

user

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

committer

object

type

required

string

raw

The raw committer value from the repository. This may be the only value available if the committer does not match a user in Bitbucket.

string

user

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

message

string

summary

object

raw

The text as it was typed by a user.

string

markup

The type of markup language the raw content is to be interpreted in.

string

Allowed values: markdown creole plaintext

html

The user’s content rendered as HTML.

string

parents

Array<object> recursive

repository

object

type

required

string

links

object

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

pullrequests

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

commits

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

forks

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

watchers

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

downloads

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

clone

Array<object>

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

hooks

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

uuid

The repository’s immutable id. This can be used as a substitute for the slug segment in URLs. Doing this guarantees your URLs will survive renaming of the repository by its owner, or even transfer of the repository to a different user.

string

full_name

The concatenation of the repository owner’s username and the slugified name, e.g. “evzijst/interruptingcow”. This is the same string used in Bitbucket URLs.

string

is_private

boolean

parent

object recursive

scm

string

Allowed values: git

owner

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

name

string

description

string

created_on

string format: date-time

updated_on

string format: date-time

size

integer

language

string

has_issues

The issue tracker for this repository is enabled. Issue Tracker features are not supported for repositories in workspaces administered through admin.atlassian.com.

boolean

has_wiki

The wiki for this repository is enabled. Wiki features are not supported for repositories in workspaces administered through admin.atlassian.com.

boolean

fork_policy

Controls the rules for forking this repository.

allow_forks: unrestricted forking
no_public_forks: restrict forking to private forks (forks cannot be made public later)
no_forks: deny all forking

string

Allowed values: allow_forks no_public_forks no_forks

project

object

type

required

string

links

object

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

uuid

The project’s immutable id.

string

key

The project’s key.

string

owner

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

links

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

members

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

projects

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

repositories

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

name

The name of the project.

string

description

string

is_private

Indicates whether the project is publicly accessible, or whether it is private to the team and consequently only visible to team members. Note that private projects cannot contain public repositories.

boolean

created_on

string format: date-time

updated_on

string format: date-time

has_publicly_visible_repos

Indicates whether the project contains publicly visible repositories. Note that private projects cannot contain public repositories.

boolean

mainbranch

object

type

required

string

links

object

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

commits

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

name

The name of the ref.

string

target

object recursive

merge_strategies

Available merge strategies for pull requests targeting this branch.

Array<string>

Allowed values: merge_commit squash fast_forward squash_fast_forward rebase_fast_forward rebase_merge

default_merge_strategy

The default merge strategy for pull requests targeting this branch.

string

participants

Array

object

type

required

string

user

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

role

string

Allowed values: PARTICIPANT REVIEWER

approved

boolean

state

string

Allowed values: approved changes_requested

participated_on

The ISO8601 timestamp of the participant’s action. For approvers, this is the time of their approval. For commenters and pull request reviewers who are not approvers, this is the time they last commented, or null if they have not commented.

string format: date-time

attributes

string

Allowed values: link executable subrepository binary lfs

escaped_path

The escaped version of the path as it appears in a diff. If the path does not require escaping this will be the same as path.

string

key

additional properties

any

new

Commit File

A file object, representing a file at a commit in a repository

object

type

required

string

path

The path in the repository

string

commit

object

type

required

string

hash

string

/[0-9a-f]{7,}?/

date

string format: date-time

author

object

type

required

string

raw

The raw author value from the repository. This may be the only value available if the author does not match a user in Bitbucket.

string

user

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

committer

object

type

required

string

raw

The raw committer value from the repository. This may be the only value available if the committer does not match a user in Bitbucket.

string

user

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

message

string

summary

object

raw

The text as it was typed by a user.

string

markup

The type of markup language the raw content is to be interpreted in.

string

Allowed values: markdown creole plaintext

html

The user’s content rendered as HTML.

string

parents

Array<object> recursive

repository

object

type

required

string

links

object

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

pullrequests

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

commits

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

forks

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

watchers

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

downloads

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

clone

Array<object>

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

hooks

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

uuid

string

full_name

The concatenation of the repository owner’s username and the slugified name, e.g. “evzijst/interruptingcow”. This is the same string used in Bitbucket URLs.

string

is_private

boolean

parent

object recursive

scm

string

Allowed values: git

owner

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

name

string

description

string

created_on

string format: date-time

updated_on

string format: date-time

size

integer

language

string

has_issues

The issue tracker for this repository is enabled. Issue Tracker features are not supported for repositories in workspaces administered through admin.atlassian.com.

boolean

has_wiki

The wiki for this repository is enabled. Wiki features are not supported for repositories in workspaces administered through admin.atlassian.com.

boolean

fork_policy

Controls the rules for forking this repository.

allow_forks: unrestricted forking
no_public_forks: restrict forking to private forks (forks cannot be made public later)
no_forks: deny all forking

string

Allowed values: allow_forks no_public_forks no_forks

project

object

type

required

string

links

object

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

uuid

The project’s immutable id.

string

key

The project’s key.

string

owner

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

links

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

members

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

projects

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

repositories

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

name

The name of the project.

string

description

string

is_private

boolean

created_on

string format: date-time

updated_on

string format: date-time

has_publicly_visible_repos

Indicates whether the project contains publicly visible repositories. Note that private projects cannot contain public repositories.

boolean

mainbranch

object

type

required

string

links

object

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

commits

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

name

The name of the ref.

string

target

object recursive

merge_strategies

Available merge strategies for pull requests targeting this branch.

Array<string>

Allowed values: merge_commit squash fast_forward squash_fast_forward rebase_fast_forward rebase_merge

default_merge_strategy

The default merge strategy for pull requests targeting this branch.

string

participants

Array

object

type

required

string

user

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

role

string

Allowed values: PARTICIPANT REVIEWER

approved

boolean

state

string

Allowed values: approved changes_requested

participated_on

string format: date-time

attributes

string

Allowed values: link executable subrepository binary lfs

escaped_path

The escaped version of the path as it appears in a diff. If the path does not require escaping this will be the same as path.

string

key

additional properties

any

key

additional properties

any

Examples

response

{
  "pagelen": 500,
  "values": [
    {
      "type": "diffstat",
      "status": "modified",
      "lines_removed": 1,
      "lines_added": 2,
      "old": {
        "path": "setup.py",
        "escaped_path": "setup.py",
        "type": "commit_file",
        "links": {
          "self": {
            "href": "https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/src/e1749643d655d7c7014001a6c0f58abaf42ad850/setup.py"
          }
        }
      },
      "new": {
        "path": "setup.py",
        "escaped_path": "setup.py",
        "type": "commit_file",
        "links": {
          "self": {
            "href": "https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/src/d222fa235229c55dad20b190b0b571adf737d5a6/setup.py"
          }
        }
      }
    }
  ],
  "page": 1,
  "size": 1
}

555

If generating the diffstat timed out.

application/json

Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object

type

required

string

error

object

message

required

string

detail

string

data

Optional structured data that is endpoint-specific.

object

key

additional properties

any

key

additional properties

any

Example ^generated

{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}

Compare two commit diff stats

Single commit spec

Two commit spec

Authorizations

Parameters

Path Parameters

Query Parameters

Responses

200

Examples

555

Example generated

Example ^generated