API Documentation
Repository Management
Repository Manipulation
- GETGet details of an existing repo.
- DELDelete a repo.
- POSTImport a Git repo into this Diversion repo
- POSTCheck if a git repo could be imported to Diversion
- POSTSync a Git repo to this Diversion repo
- GETGet file tree snapshot. Either one of workspace, branch or commit ID needs to be specified as ref ID.
- GETGet file tree snapshot for a nested tree path. Either one of workspace, branch or commit ID needs to be specified as ref ID.
- GETGet object history in a ref by its latest path
- GETGet file entry (either tree or blob). Either one of workspace, branch or commit ID needs to be specified.
- GETGet blob contents snapshot. Either one of workspace, branch or commit ID needs to be specified.
- GETGet blob contents using storage information, as retrieved from other APIs.
Repository Commit Manipulation
Repository Workspace Manipulation
- GETGet repos workspaces
- POSTCreate a workspace
- GETGet repos workspaces 1
- POSTUpdate workspace name
- POSTWorkspace checkout ref
- GETGet updates needed to be applied by the client to this workspace
- GETGet status of changes in workspace
- POSTReset changes in workspace
- POSTMerge base branch into workspace
- GETGet preferences of the current user
- PUTUpdate the preferences of the current user
- GETGet list of potential clashes with files in other users' workspaces and branches
Repository Branch Manipulation
Repository Tag Manipulation
Repository Shelves Manipulation
File Mutation
Repository Merge Manipulation
- GETDetails of a specific merge in progress
- POSTAfter all conflicts are resolved, finalizes the merge with a commit
- POSTClose an open merge without resolving it
- POSTAccepts a change from one of the branches (base or other)
- POSTUpdate a conflicting file, potentially resolving the conflict.
- GETRetrieve conflicted merges in this repo
- POSTMerge ref into a branch
Collaborators
Repository Content Comparison
Github App Integration
Repository Workspace Manipulation
Get repos workspaces
List user’s workspaces
GET
/
repos
/
{repo_id}
/
workspaces
curl --request GET \
--url https://api.diversion.dev/v0/repos/{repo_id}/workspaces \
--header 'Authorization: Bearer <token>'{
"object": "Workspace",
"items": [
{
"workspace_id": "<string>",
"name": "<string>",
"source_commit": "<string>",
"branch_id": "<string>",
"base_commit_id": "<string>",
"repo_id": "<string>",
"journal_ordinal_id": 123
}
]
}Authorizations
This API uses OAuth 2 with the implicit grant flow
Path Parameters
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 - 128Response
200
application/json
Success
Available options:
Workspace curl --request GET \
--url https://api.diversion.dev/v0/repos/{repo_id}/workspaces \
--header 'Authorization: Bearer <token>'{
"object": "Workspace",
"items": [
{
"workspace_id": "<string>",
"name": "<string>",
"source_commit": "<string>",
"branch_id": "<string>",
"base_commit_id": "<string>",
"repo_id": "<string>",
"journal_ordinal_id": 123
}
]
}