OXoxen
Commits

Upload commit

Upload a commit to a branch on the server. This creates an empty commit. Its merkle tree nodes are uploaded separately through the tree nodes endpoint.

post/api/repos/{namespace}/{repo_name}/commits

Request

Path parameters

namespacestring required

Namespace of the repository

repo_namestring required

Name of the repository

Request body

authorstring required
emailstring required
idstring required
messagestring required
parent_idsstring[] required
timestampstring date-time required

Example request

{
  "author": "ox",
  "email": "ox@example.com",
  "id": "a1b2c3d4e5f67890abcdef1234567890",
  "message": "Refactor data loading pipeline.",
  "parent_ids": [
    "f1e2d3c4b5a67890fedcba9876543210"
  ],
  "timestamp": "2025-01-01T10:00:00Z"
}

Response

Commit created

oxen_versionstring nullable
statusstring required
status_messagestring required

Example response

{
  "commit": {
    "author": "ox",
    "email": "ox@example.com",
    "id": "a1b2c3d4e5f67890abcdef1234567890",
    "message": "Refactor data loading pipeline.",
    "parent_ids": [
      "f1e2d3c4b5a67890fedcba9876543210"
    ],
    "timestamp": "2025-01-01T10:00:00Z"
  },
  "status": "success",
  "status_message": "resource_found"
}

Changes

No recorded changes to this operation across all 1 revision of this API.