Skip to main content
POST
/
api
/
repos
/
{namespace}
/
{repo_name}
/
import
/
upload
/
{resource}
Upload zip archive
curl --request POST \
  --url https://hub.oxen.ai/api/repos/{namespace}/{repo_name}/import/upload/{resource} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'commit_message=Importing full archive of grazing data' \
  --form email=ox@oxen.ai \
  --form file='@example-file' \
  --form name=ox
{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://oxenai-eric-revamp-getting-started.mintlify.app/llms.txt

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

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
namespace
string
required

Namespace of the repository

​
repo_name
string
required

Name of the repository

​
resource
string
required

Destination path (including branch)

Body

multipart/form-data

Body for uploading a zip archive via multipart/form-data

​
file
file
required
​
commit_message
string | null
Example:

"Importing dataset archive"

​
email
string | null
Example:

"ox@oxen.ai"

​
name
string | null
Example:

"ox"

Response

Zip archive decompressed and committed

​
status
string
required
​
status_message
string
required
​
commit
object
required
Example:
{
  "author": "ox",
  "email": "ox@example.com",
  "id": "a1b2c3d4e5f67890abcdef1234567890",
  "message": "Refactor data loading pipeline.",
  "parent_ids": ["f1e2d3c4b5a67890fedcba9876543210"],
  "timestamp": "2025-01-01T10:00:00Z"
}
​
oxen_version
string | null