Skip to main content
GET
/
repos
/
{repo_id}
/
files
/
{ref_id}
/
{path}
Get file entry (either tree or blob). Either one of workspace, branch or commit ID needs to be specified.
curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/files/{ref_id}/{path} \
  --header 'Authorization: Bearer <token>'
{
  "path": "hello.cc",
  "status": 1,
  "mode": 16877,
  "prev_path": "<string>",
  "mtime": "2023-11-07T05:31:56Z",
  "blob": {
    "storage_uri": "repo_id/2aae6c35c94fcfb415dbe95f408b9ce91ee846ed",
    "storage_backend": 1,
    "size": 123,
    "sha": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
path
string<path>
required

A path to a file inside the repository.

Example:

"/path/to/file"

Response

File information

​
path
string
required
Example:

"hello.cc"

​
status
enum<integer>
required

One of: 1 - INTACT, 2 - ADDED, 3 - MODIFIED, 4 - DELETED

Available options:
1,
2,
3,
4
​
mode
enum<integer>
required

The file mode (as Unix mode)

Available options:
16877,
33188,
33261,
40960
​
prev_path
string

Optional hint in case the item was renamed or moved

​
mtime
string<date-time>
​
blob
object