Import

Import file from URL

Import a file from a remote URL and commit it to the repository.

post/api/repos/{namespace}/{repo_name}/import/{resource}

Request

Path parameters

namespacestring required

Namespace of the repository

repo_namestring required

Name of the repository

resourcestring required

Destination path (including branch)

Request body

authstring nullable
download_urlstring required
emailstring nullable
filenamestring nullable
messagestring nullable
namestring nullable

Example request

{
  "auth": "Bearer <token>",
  "download_url": "https://example.com/datasets/data.csv",
  "email": "ox@oxen.ai",
  "filename": "data.csv",
  "message": "Import dataset",
  "name": "ox"
}

Response

File imported and committed

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.