Atlassian Commits API

openapi: 3.2.0
info:
  title: Atlassian Bitbucket Commits API
  description: Code against the Bitbucket API to automate simple tasks, embed Bitbucket data into your own site, build mobile or desktop apps, or even add custom UI add-ons into Bitbucket itself using the Connect framework.
  version: '2.0'
  termsOfService: https://www.atlassian.com/legal/customer-agreement
  contact:
    name: Bitbucket Support
    url: https://support.atlassian.com/bitbucket-cloud/
    email: support@bitbucket.org
servers:
- url: https://api.bitbucket.org/2.0
tags:
- name: Commits
  description: 'These are the repository''s commits. They are paginated and returned in

    reverse chronological order, similar to the output of git log.

    '
paths:
  /repositories/{workspace}/{repo_slug}/commit/{commit}:
    parameters:
    - name: commit
      in: path
      description: The commit's SHA1.
      required: true
      schema:
        type: string
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    get:
      tags:
      - Commits
      description: Returns the specified commit.
      summary: Atlassian Get A Commit
      responses:
        '200':
          description: The commit object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/commit'
              examples:
                response:
                  value:
                    rendered:
                      message:
                        raw: Add a GEORDI_OUTPUT_DIR setting
                        markup: markdown
                        html: <p>Add a GEORDI_OUTPUT_DIR setting</p>
                        type: rendered
                    hash: f7591a13eda445d9a9167f98eb870319f4b6c2d8
                    repository:
                      name: geordi
                      type: repository
                      full_name: bitbucket/geordi
                      links:
                        self:
                          href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi
                        html:
                          href: https://bitbucket.org/bitbucket/geordi
                        avatar:
                          href: https://bytebucket.org/ravatar/%7B85d08b4e-571d-44e9-a507-fa476535aa98%7D?ts=1730260
                      uuid: '{85d08b4e-571d-44e9-a507-fa476535aa98}'
                    links:
                      self:
                        href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/commit/f7591a13eda445d9a9167f98eb870319f4b6c2d8
                      comments:
                        href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/commit/f7591a13eda445d9a9167f98eb870319f4b6c2d8/comments
                      patch:
                        href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/patch/f7591a13eda445d9a9167f98eb870319f4b6c2d8
                      html:
                        href: https://bitbucket.org/bitbucket/geordi/commits/f7591a13eda445d9a9167f98eb870319f4b6c2d8
                      diff:
                        href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/diff/f7591a13eda445d9a9167f98eb870319f4b6c2d8
                      approve:
                        href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/commit/f7591a13eda445d9a9167f98eb870319f4b6c2d8/approve
                      statuses:
                        href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/commit/f7591a13eda445d9a9167f98eb870319f4b6c2d8/statuses
                    author:
                      raw: Brodie Rao <a@b.c>
                      type: author
                      user:
                        display_name: Brodie Rao
                        uuid: '{9484702e-c663-4afd-aefb-c93a8cd31c28}'
                        links:
                          self:
                            href: https://api.bitbucket.org/2.0/users/%7B9484702e-c663-4afd-aefb-c93a8cd31c28%7D
                          html:
                            href: https://bitbucket.org/%7B9484702e-c663-4afd-aefb-c93a8cd31c28%7D/
                          avatar:
                            href: https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/557058:3aae1e05-702a-41e5-81c8-f36f29afb6ca/613070db-28b0-421f-8dba-ae8a87e2a5c7/128
                        type: user
                        nickname: brodie
                        account_id: 557058:3aae1e05-702a-41e5-81c8-f36f29afb6ca
                    summary:
                      raw: Add a GEORDI_OUTPUT_DIR setting
                      markup: markdown
                      html: <p>Add a GEORDI_OUTPUT_DIR setting</p>
                      type: rendered
                    participants: []
                    parents:
                    - type: commit
                      hash: f06941fec4ef6bcb0c2456927a0cf258fa4f899b
                      links:
                        self:
                          href: https://api.bitbucket.org/2.0/repositories/bitbucket/geordi/commit/f06941fec4ef6bcb0c2456927a0cf258fa4f899b
                        html:
                          href: https://bitbucket.org/bitbucket/geordi/commits/f06941fec4ef6bcb0c2456927a0cf258fa4f899b
                    date: '2012-07-16T19:37:54+00:00'
                    message: Add a GEORDI_OUTPUT_DIR setting
                    type: commit
        '404':
          description: If the specified commit or repository does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianGetACommit
  /repositories/{workspace}/{repo_slug}/commit/{commit}/approve:
    parameters:
    - name: commit
      in: path
      description: The commit's SHA1.
      required: true
      schema:
        type: string
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    delete:
      tags:
      - Commits
      description: Redact the authenticated user's approval of the specified commit.<br><br>This operation is only available to users that have explicit access to<br>the repository. In contrast, just the fact that a repository is<br>publicly accessible to users does not give them the ability to approve<br>commits.
      summary: Atlassian Unapprove A Commit
      responses:
        '204':
          description: An empty response indicating the authenticated user's approval has been withdrawn.
        '404':
          description: If the specified commit, or the repository does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository:write
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - write:repository:bitbucket
      operationId: atlassianUnapproveACommit
    post:
      tags:
      - Commits
      description: Approve the specified commit as the authenticated user.<br><br>This operation is only available to users that have explicit access to<br>the repository. In contrast, just the fact that a repository is<br>publicly accessible to users does not give them the ability to approve<br>commits.
      summary: Atlassian Approve A Commit
      responses:
        '200':
          description: The `participant` object recording that the authenticated user approved the commit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/participant'
        '404':
          description: If the specified commit, or the repository does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository:write
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
        - write:repository:bitbucket
      operationId: atlassianApproveACommit
  /repositories/{workspace}/{repo_slug}/commit/{commit}/comments:
    parameters:
    - name: commit
      in: path
      description: The commit's SHA1.
      required: true
      schema:
        type: string
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    get:
      tags:
      - Commits
      description: Returns the commit's comments.<br><br>This includes both global and inline comments.<br><br>The default sorting is oldest to newest and can be overridden with<br>the `sort` query parameter.
      summary: Atlassian List A Commit S Comments
      responses:
        '200':
          description: A paginated list of commit comments.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/paginated_commit_comments'
      parameters:
      - name: q
        in: query
        description: 'Query string to narrow down the response as per

          [filtering and sorting](/cloud/bitbucket/rest/intro/#filtering).

          '
        required: false
        schema:
          type: string
      - name: sort
        in: query
        description: 'Field by which the results should be sorted as per

          [filtering and sorting](/cloud/bitbucket/rest/intro/#filtering).

          '
        required: false
        schema:
          type: string
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianListACommitSComments
    post:
      tags:
      - Commits
      description: 'Creates new comment on the specified commit.<br><br>To post a reply to an existing comment, include the `parent.id` field:<br><br>```<br>$ curl https://api.bitbucket.org/2.0/repositories/atlassian/prlinks/commit/db9ba1e031d07a02603eae0e559a7adc010257fc/comments/ \<br>  -X POST -u evzijst \<br>  -H ''Content-Type: application/json'' \<br>  -d ''{"content": {"raw": "One more thing!"},<br>       "parent": {"id": 5728901}}''<br>```'
      summary: Atlassian Create Comment For A Commit
      responses:
        '201':
          description: The newly created comment.
          headers:
            Location:
              description: The location of the newly created comment.
              schema:
                type: string
        '400':
          description: If the comment was detected as spam, or if the parent comment is not attached to the same node as the new comment
        '404':
          description: If a parent ID was passed in that cannot be found
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/commit_comment'
        description: The specified comment.
        required: true
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianCreateCommentForACommit
  /repositories/{workspace}/{repo_slug}/commit/{commit}/comments/{comment_id}:
    parameters:
    - name: comment_id
      in: path
      description: The id of the comment.
      required: true
      schema:
        type: integer
    - name: commit
      in: path
      description: The commit's SHA1.
      required: true
      schema:
        type: string
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    delete:
      tags:
      - Commits
      description: Deletes the specified commit comment.<br><br>Note that deleting comments that have visible replies that point to<br>them will not really delete the resource. This is to retain the integrity<br>of the original comment tree. Instead, the `deleted` element is set to<br>`true` and the content is blanked out. The comment will continue to be<br>returned by the collections and self endpoints.
      summary: Atlassian Delete A Commit Comment
      responses:
        '204':
          description: Indicates the comment was deleted by this action or a previous delete.
        '404':
          description: If the comment doesn't exist
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianDeleteACommitComment
    get:
      tags:
      - Commits
      description: Returns the specified commit comment.
      summary: Atlassian Get A Commit Comment
      responses:
        '200':
          description: The commit comment.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/commit_comment'
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianGetACommitComment
    put:
      tags:
      - Commits
      description: 'Used to update the contents of a comment. Only the content of the comment can be updated.<br><br>```<br>$ curl https://api.bitbucket.org/2.0/repositories/atlassian/prlinks/commit/7f71b5/comments/5728901 \<br>  -X PUT -u evzijst \<br>  -H ''Content-Type: application/json'' \<br>  -d ''{"content": {"raw": "One more thing!"}''<br>```'
      summary: Atlassian Update A Commit Comment
      responses:
        '201':
          description: The newly updated comment.
          headers:
            Location:
              description: The location of the newly updated comment.
              schema:
                type: string
        '400':
          description: If the comment update was detected as spam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/commit_comment'
        description: The updated comment.
        required: true
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianUpdateACommitComment
  /repositories/{workspace}/{repo_slug}/commits:
    parameters:
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    get:
      tags:
      - Commits
      description: These are the repository's commits. They are paginated and returned<br>in reverse chronological order, similar to the output of `git log`.<br>Like these tools, the DAG can be filtered.<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/<br><br>Returns all commits in the repo in topological order (newest commit<br>first). All branches and tags are included (similar to<br>`git log --all`).<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/?exclude=master<br><br>Returns all commits in the repo that are not on master<br>(similar to `git log --all ^master`).<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/?include=foo&include=bar&exclude=fu&exclude=fubar<br><br>Returns all commits that are on refs `foo` or `bar`, but not on `fu` or<br>`fubar` (similar to `git log foo bar ^fu ^fubar`).<br><br>An optional `path` parameter can be specified that will limit the<br>results to commits that affect that path. `path` can either be a file<br>or a directory. If a directory is specified, commits are returned that<br>have modified any file in the directory tree rooted by `path`. It is<br>important to note that if the `path` parameter is specified, the commits<br>returned by this endpoint may no longer be a DAG, parent commits that<br>do not modify the path will be omitted from the response.<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/?path=README.md&include=foo&include=bar&exclude=master<br><br>Returns all commits that are on refs `foo` or `bar`, but not on `master`<br>that changed the file README.md.<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/?path=src/&include=foo&include=bar&exclude=master<br><br>Returns all commits that are on refs `foo` or `bar`, but not on `master`<br>that changed to a file in any file in the directory src or its children.<br><br>Because the response could include a very large number of commits, it<br>is paginated. Follow the 'next' link in the response to navigate to the<br>next page of commits. As with other paginated resources, do not<br>construct your own links.<br><br>When the include and exclude parameters are more than can fit in a<br>query string, clients can use a `x-www-form-urlencoded` POST instead.
      summary: Atlassian List Commits
      responses:
        '200':
          description: A paginated list of commits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/paginated_changeset'
        '404':
          description: If the specified repository does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianListCommits
    post:
      tags:
      - Commits
      description: Identical to `GET /repositories/{workspace}/{repo_slug}/commits`,<br>except that POST allows clients to place the include and exclude<br>parameters in the request body to avoid URL length issues.<br><br>**Note that this resource does NOT support new commit creation.**
      summary: Atlassian List Commits With Include Exclude
      responses:
        '200':
          description: A paginated list of commits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/paginated_changeset'
        '404':
          description: If the specified repository does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianListCommitsWithIncludeExclude
  /repositories/{workspace}/{repo_slug}/commits/{revision}:
    parameters:
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: revision
      in: path
      description: A commit SHA1 or ref name.
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    get:
      tags:
      - Commits
      description: These are the repository's commits. They are paginated and returned<br>in reverse chronological order, similar to the output of `git log`.<br>Like these tools, the DAG can be filtered.<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/master<br><br>Returns all commits on ref `master` (similar to `git log master`).<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/dev?include=foo&exclude=master<br><br>Returns all commits on ref `dev` or `foo`, except those that are reachable on<br>`master` (similar to `git log dev foo ^master`).<br><br>An optional `path` parameter can be specified that will limit the<br>results to commits that affect that path. `path` can either be a file<br>or a directory. If a directory is specified, commits are returned that<br>have modified any file in the directory tree rooted by `path`. It is<br>important to note that if the `path` parameter is specified, the commits<br>returned by this endpoint may no longer be a DAG, parent commits that<br>do not modify the path will be omitted from the response.<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/dev?path=README.md&include=foo&include=bar&exclude=master<br><br>Returns all commits that are on refs `dev` or `foo` or `bar`, but not on `master`<br>that changed the file README.md.<br><br>#### GET /repositories/{workspace}/{repo_slug}/commits/dev?path=src/&include=foo&exclude=master<br><br>Returns all commits that are on refs `dev` or `foo`, but not on `master`<br>that changed to a file in any file in the directory src or its children.<br><br>Because the response could include a very large number of commits, it<br>is paginated. Follow the 'next' link in the response to navigate to the<br>next page of commits. As with other paginated resources, do not<br>construct your own links.<br><br>When the include and exclude parameters are more than can fit in a<br>query string, clients can use a `x-www-form-urlencoded` POST instead.
      summary: Atlassian List Commits For Revision
      responses:
        '200':
          description: A paginated list of commits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/paginated_changeset'
        '404':
          description: If the specified revision does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianListCommitsForRevision
    post:
      tags:
      - Commits
      description: Identical to `GET /repositories/{workspace}/{repo_slug}/commits/{revision}`,<br>except that POST allows clients to place the include and exclude<br>parameters in the request body to avoid URL length issues.<br><br>**Note that this resource does NOT support new commit creation.**
      summary: Atlassian List Commits For Revision Using Include Exclude
      responses:
        '200':
          description: A paginated list of commits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/paginated_changeset'
        '404':
          description: If the specified revision does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianListCommitsForRevisionUsingIncludeExclude
  /repositories/{workspace}/{repo_slug}/diff/{spec}:
    parameters:
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: spec
      in: path
      description: 'A commit SHA (e.g. `3a8b42`) or a commit range using double dot

        notation (e.g. `3a8b42..9ff173`).

        '
      required: true
      schema:
        type: string
    - name: workspace
      in: path
      description: 'This can either be the workspace ID (slug) or the workspace UUID

        surrounded by curly-braces, for example: `{workspace UUID}`.

        '
      required: true
      schema:
        type: string
    get:
      tags:
      - Commits
      description: 'Produces a raw git-style diff.<br><br>#### Single commit spec<br><br>If the `spec` argument to this API is a single commit, the diff is<br>produced against the first parent of the specified commit.<br><br>#### Two commit spec<br><br>Two commits separated by `..` may be provided as the `spec`, e.g.,<br>`3a8b42..9ff173`. When two commits are provided and the `topic` query<br>parameter is true, this API produces a 2-way three dot diff.<br>This is the diff between source commit and the merge base of the source<br>commit and the destination commit. When the `topic` query param is false,<br>a simple git-style diff is produced.<br><br>The two commits are interpreted as follows:<br><br>* First commit: the commit containing the changes we wish to preview<br>* Second commit: the commit representing the state to which we want to<br>  compare the first commit<br>* **Note**: This is the opposite of the order used in `git diff`.<br><br>#### Comparison to patches<br><br>While similar to patches, diffs:<br><br>* Don''t have a commit header (username, commit message, etc)<br>* Support the optional `path=foo/bar.py` query param to filter<br>  the diff to just that one file diff<br><br>#### Response<br><br>The raw diff is returned as-is, in whatever encoding the files in the<br>repository use. It is not decoded into unicode. As such, the<br>content-type is `text/plain`.'
      summary: Atlassian Compare Two Commits
      responses:
        '200':
          description: The raw diff
        '555':
          description: 'If the diff was too large and timed out.


            Since this endpoint does not employ any form of pagination, but

            instead returns the diff as a single document, it can run into

            trouble on very large diffs. If Bitbucket times out in cases

            like these, a 555 status code is returned.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      parameters:
      - name: context
        in: query
        description: Generate diffs with <n> lines of context instead of the usual three.
        required: false
        schema:
          type: integer
      - name: path
        in: query
        description: 'Limit the diff to a particular file (this parameter

          can be repeated for multiple paths).'
        required: false
        schema:
          type: string
      - name: ignore_whitespace
        in: query
        description: Generate diffs that ignore whitespace.
        required: false
        schema:
          type: boolean
      - name: binary
        in: query
        description: Generate diffs that include binary files, true if omitted.
        required: false
        schema:
          type: boolean
      - name: renames
        in: query
        description: Whether to perform rename detection, true if omitted.
        required: false
        schema:
          type: boolean
      - name: merge
        in: query
        description: '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 diff from the

          destination to the merge result is returned. If false,

          a simple ''two dot'' diff between the source and

          destination is returned. True if omitted.'
        required: false
        schema:
          type: boolean
      - name: topic
        in: query
        description: '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.'
        required: false
        schema:
          type: boolean
      security:
      - oauth2:
        - repository
      - basic: []
      - api_key: []
      x-atlassian-oauth2-scopes:
      - state: Current
        scheme: oauth2
        scopes:
        - read:repository:bitbucket
      operationId: atlassianCompareTwoCommits
  /repositories/{workspace}/{repo_slug}/diffstat/{spec}:
    parameters:
    - name: ignore_whitespace
      in: query
      description: Generate diffs that ignore whitespace
      required: false
      schema:
        type: boolean
    - name: merge
      in: query
      description: '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.'
      required: false
      schema:
        type: boolean
    - name: path
      in: query
      description: 'Limit the diffstat to a particular file (this parameter

        can be repeated for multiple paths).'
      required: false
      schema:
        type: string
    - name: renames
      in: query
      description: Whether to perform rename detection, true if omitted.
      required: false
      schema:
        type: boolean
    - name: repo_slug
      in: path
      description: 'This can either be the repository slug or the UUID of the repository,

        surrounded by curly-braces, for example: `{repository UUID}`.

        '
      required: true
      schema:
        type: string
    - name: spec
      in: path
      description: 'A commit SHA (e.g. `3a8b42`) or a commit range using double dot

        notation (e.g. `3a8b42..9ff173`).

        '
      required: true
      schema:
        type: string
    - name: topic
      in: query
      description: 'If true, returns 2-way ''three-dot'' diff.

        This is a diff b

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