GET
/
repos
/
{repo_id}
/
compare
curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/compare \
  --header 'Authorization: Bearer <token>'
{
  "object": "ComparisonItem",
  "items": [
    {
      "base_item": {
        "path": "hello.cc",
        "prev_path": "<string>",
        "hash": "6fd9c4d3e03367130c3c5e296f5a6cf1e880fdfe",
        "prev_hash": "327960059fb70e19eeb72ddea5b60807c4af58b7",
        "status": 1,
        "mode": 16877,
        "mtime": "2023-11-07T05:31:56Z",
        "blob": {
          "storage_uri": "repo_id/2aae6c35c94fcfb415dbe95f408b9ce91ee846ed:128-1023",
          "storage_backend": 123,
          "size": 123,
          "sha": "<string>",
          "temp_download_url": "<string>",
          "content_base64": "<string>"
        }
      },
      "other_item": {
        "path": "hello.cc",
        "prev_path": "<string>",
        "hash": "6fd9c4d3e03367130c3c5e296f5a6cf1e880fdfe",
        "prev_hash": "327960059fb70e19eeb72ddea5b60807c4af58b7",
        "status": 1,
        "mode": 16877,
        "mtime": "2023-11-07T05:31:56Z",
        "blob": {
          "storage_uri": "repo_id/2aae6c35c94fcfb415dbe95f408b9ce91ee846ed:128-1023",
          "storage_backend": 123,
          "size": 123,
          "sha": "<string>",
          "temp_download_url": "<string>",
          "content_base64": "<string>"
        }
      },
      "status": 1
    }
  ],
  "cascaded_changes_count": 123
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

​
repo_id
string
required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128
Example:

"example_id"

Query Parameters

​
base_id
string
default:""

A workspace_id, branch_id, commit_id or tag_id. If omitted, assuming the empty tree, unless other_id is a workspace, in which case base_id is assumed to be the workspace base ref. If recurse is set to all_changes, new/deleted folders will be recursed into, to include the children. If recurse is set to modified (default), only the modified folders will be recursed into. New/deleted folders will be 'collapsed' into a single entry.

Maximum length: 128
​
other_id
string

A reference to a source version from which changes will be taken

Required string length: 3 - 128
Example:

"example_id"

​
recurse
enum<string>
default:modified

Specifies whether to include cascaded new/deleted folders (all_changes) or not (modified).

Available options:
modified,
all_changes

Response

200 - application/json

A list of tree comparison objects

The response is of type object.