GET
/
repos
/
{repo_id}
/
trees
/
{ref_id}
curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/trees/{ref_id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "FileEntry",
  "items": [
    {
      "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>"
      }
    }
  ],
  "workspace_journal_ordinal_id": 123,
  "total_expected_items": 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"

​
ref_id
string
required

An ID of a workspace, branch or commit.

Required string length: 3 - 128
Example:

"example_id"

Query Parameters

​
path
string

Optional path to an item inside the repository.

Example:

"/path/to/file"

​
recurse
boolean
default:true

Specifies if to recursively iterate file tree to next directory levels

​
skip
integer

Skip a number of items returned from a listing api

Required range: x >= 0
Example:

17

​
limit
integer
default:1500

Limit the number of entries returned from walk

Required range: x >= 1
Example:

17

​
offset
string

Offset item name in directory when iterating its entries (non-inclusive)

Example:

"file.ext"

​
include_deleted
boolean
default:false

Should the tree contain also deleted items or omit them from response

​
workspace_journal_ordinal_id
integer

The ordinal ID of the journal entry the walk references, if applicable

​
item_name_query
string

A query string to test against item name, only matching items will be collected

Required string length: 3 - 128
Example:

"abcd"

​
dirs_only
boolean
default:false

Return only directories in the file tree walk

​
use_selective_sync
boolean
default:true

Return the results filtered by the workspace preferences for selective sync

​
max_depth
integer
default:1
​
ignore_journal_ordinal_diff
boolean
default:false

Specifies if to ignore the journal ordinal id difference and potentially return intermediate state

​
include_download_urls
boolean
default:false

Specifies whether to include download URLs in the response

Response

200
application/json

Success

The response is of type object.