GET
/
repos
/
{repo_id}
/
workspaces
/
{workspace_id}
/
status
curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/workspaces/{workspace_id}/status \
  --header 'Authorization: Bearer <token>'
{
  "changed_items_count": 123,
  "changed_files_count": 123,
  "incomplete_result": true,
  "items": {
    "new": [
      {
        "path": "hello.cc",
        "prev_path": "<string>",
        "status": 1,
        "mode": 16877,
        "mtime": "2023-11-07T05:31:56Z",
        "blob": {
          "storage_uri": "repo_id/2aae6c35c94fcfb415dbe95f408b9ce91ee846ed",
          "storage_backend": 1,
          "size": 123,
          "sha": "<string>"
        }
      }
    ],
    "modified": [
      {
        "path": "hello.cc",
        "prev_path": "<string>",
        "status": 1,
        "mode": 16877,
        "mtime": "2023-11-07T05:31:56Z",
        "blob": {
          "storage_uri": "repo_id/2aae6c35c94fcfb415dbe95f408b9ce91ee846ed",
          "storage_backend": 1,
          "size": 123,
          "sha": "<string>"
        }
      }
    ],
    "deleted": [
      {
        "path": "hello.cc",
        "prev_path": "<string>",
        "status": 1,
        "mode": 16877,
        "mtime": "2023-11-07T05:31:56Z",
        "blob": {
          "storage_uri": "repo_id/2aae6c35c94fcfb415dbe95f408b9ce91ee846ed",
          "storage_backend": 1,
          "size": 123,
          "sha": "<string>"
        }
      }
    ]
  },
  "conflicts": [
    "<string>"
  ]
}

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"

​
workspace_id
string
required

The repo ID of the workspace.

Required string length: 3 - 128
Example:

"example_id"

Query Parameters

​
detail_items
boolean
default:true

Should detail all the changed items in status response

​
limit
integer

Limit the number of entries returned from walk

Required range: x >= 1
Example:

17

​
recurse
boolean
default:true

Specifies if to recursively iterate file tree to next directory levels

​
path_prefix
string

A path prefix in the file tree to walk under

Example:

"path/to/file"

Response

200
application/json

The changes made to this workspace since the commit it's based upon.

The status of the workspace, meaning its bill of changes. It will contain the total number of changed items and specifically changed files. If paths details were requested, it will also contain an object having 'new', 'modified', 'deleted' arrays of file entries, sorted lexicographically.