Repository API
Branches
- POSTMerge an incoming commit into a branch
- GETGet a specific branch
- PUTUpdate a branch to a new commit
- DELDelete a branch
- GETCheck if a branch is locked
- POSTLock a branch (prevents writes)
- GETGet Latest Commit for Branch
- POSTUnlock a branch (allows writes)
- GETList file history/versions for a path on a branch
- GETList all branches
- POSTCreate a new branch
Commits
- POSTUpload commits DB
- GETDownload commits DB
- POSTUpload data chunk
- POSTNotify upload complete
- GETGet root commit
- POSTMark commits as synced
- GETGet commit
- GETDownload commit entries DB
- GETList commits
- POSTCreate commit
- GETList commit history
- GETList missing commits
- GETList files missing on the server within a commit range
- POSTUpload commit tree
- GETList all commits
- GETDownload dir hashes DB
- GETList commit parents
get_data_frame_from_tabular_diff
Compare
Workspace Files
Repositories
Version Files
Workspaces
Compare Data Frames
get_diff_tree
Namespaces
list_between
Directories
Merge branches
Copy
Ask AI
curl --request POST \
--url https://hub.oxen.ai/api/repos/{namespace}/{repo_name}/merge/{base_head} \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"status": "<string>",
"status_message": "<string>",
"commits": {
"base": {
"author": "ox",
"email": "[email protected]",
"id": "a1b2c3d4e5f67890abcdef1234567890",
"message": "Refactor data loading pipeline.",
"parent_ids": [
"f1e2d3c4b5a67890fedcba9876543210"
],
"timestamp": "2025-01-01T10:00:00Z"
},
"head": {
"author": "ox",
"email": "[email protected]",
"id": "a1b2c3d4e5f67890abcdef1234567890",
"message": "Refactor data loading pipeline.",
"parent_ids": [
"f1e2d3c4b5a67890fedcba9876543210"
],
"timestamp": "2025-01-01T10:00:00Z"
},
"merge": {
"author": "ox",
"email": "[email protected]",
"id": "a1b2c3d4e5f67890abcdef1234567890",
"message": "Refactor data loading pipeline.",
"parent_ids": [
"f1e2d3c4b5a67890fedcba9876543210"
],
"timestamp": "2025-01-01T10:00:00Z"
}
},
"oxen_version": "<string>"
}Merge
Merge branches
POST
/
api
/
repos
/
{namespace}
/
{repo_name}
/
merge
/
{base_head}
Merge branches
Copy
Ask AI
curl --request POST \
--url https://hub.oxen.ai/api/repos/{namespace}/{repo_name}/merge/{base_head} \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"status": "<string>",
"status_message": "<string>",
"commits": {
"base": {
"author": "ox",
"email": "[email protected]",
"id": "a1b2c3d4e5f67890abcdef1234567890",
"message": "Refactor data loading pipeline.",
"parent_ids": [
"f1e2d3c4b5a67890fedcba9876543210"
],
"timestamp": "2025-01-01T10:00:00Z"
},
"head": {
"author": "ox",
"email": "[email protected]",
"id": "a1b2c3d4e5f67890abcdef1234567890",
"message": "Refactor data loading pipeline.",
"parent_ids": [
"f1e2d3c4b5a67890fedcba9876543210"
],
"timestamp": "2025-01-01T10:00:00Z"
},
"merge": {
"author": "ox",
"email": "[email protected]",
"id": "a1b2c3d4e5f67890abcdef1234567890",
"message": "Refactor data loading pipeline.",
"parent_ids": [
"f1e2d3c4b5a67890fedcba9876543210"
],
"timestamp": "2025-01-01T10:00:00Z"
}
},
"oxen_version": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Namespace of the repository
Name of the repository
The base and head revisions separated by '..'
⌘I