Oxen Import API
The Import API from Oxen — 2 operation(s) for import.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/oxen-import-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: oxen Ai Import API
version: 0.243.1
servers:
- url: https://hub.oxen.ai
variables: {}
security: []
tags:
- name: Import
paths:
/api/repos/{namespace}/{repo_name}/import/{resource}:
post:
description: Import a file from a remote URL and commit it to the repository.
operationId: import
parameters:
- description: Namespace of the repository
example: ox
in: path
name: namespace
required: true
schema:
type: string
- description: Name of the repository
example: Common-Crawl
in: path
name: repo_name
required: true
schema:
type: string
- description: Destination path (including branch)
example: main/data
in: path
name: resource
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
auth: Bearer <token>
download_url: https://example.com/datasets/data.csv
email: ox@oxen.ai
name: ox
schema:
$ref: '#/components/schemas/ImportFileBody'
description: Import configuration
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CommitResponse'
description: File imported and committed
'400':
description: Bad Request / Invalid URL
summary: Import file from URL
tags:
- Import
/api/repos/{namespace}/{repo_name}/import/upload/{resource}:
post:
description: Upload and decompress a zip archive into the repository and commit the contents.
operationId: upload_zip
parameters:
- description: Namespace of the repository
example: ox
in: path
name: namespace
required: true
schema:
type: string
- description: Name of the repository
example: Wiki-Text
in: path
name: repo_name
required: true
schema:
type: string
- description: Destination path (including branch)
example: main/archive
in: path
name: resource
required: true
schema:
type: string
requestBody:
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/ZipUploadBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CommitResponse'
description: Zip archive decompressed and committed
'400':
description: Bad Request
summary: Upload zip archive
tags:
- Import
components:
schemas:
Commit:
example:
author: ox
email: ox@example.com
id: a1b2c3d4e5f67890abcdef1234567890
message: Refactor data loading pipeline.
parent_ids:
- f1e2d3c4b5a67890fedcba9876543210
timestamp: '2025-01-01T10:00:00Z'
properties:
author:
type: string
email:
type: string
id:
type: string
message:
type: string
parent_ids:
items:
type: string
type: array
timestamp:
format: date-time
type: string
required:
- id
- parent_ids
- message
- author
- email
- timestamp
type: object
StatusMessage:
properties:
oxen_version:
type:
- string
- 'null'
status:
type: string
status_message:
type: string
required:
- status
- status_message
type: object
CommitResponse:
allOf:
- $ref: '#/components/schemas/StatusMessage'
- properties:
commit:
$ref: '#/components/schemas/Commit'
required:
- commit
type: object
example:
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
ZipUploadBody:
description: Body for uploading a zip archive via multipart/form-data
example:
commit_message: Importing full archive of grazing data
email: ox@oxen.ai
file: <binary zip data>
name: ox
properties:
commit_message:
example: Importing dataset archive
type:
- string
- 'null'
email:
example: ox@oxen.ai
type:
- string
- 'null'
file:
format: binary
type: string
name:
example: ox
type:
- string
- 'null'
required:
- file
title: ZipUploadBody
type: object
ImportFileBody:
description: Body for importing a file from a URL
example:
auth: Bearer <token>
download_url: https://example.com/datasets/data.csv
email: ox@oxen.ai
filename: data.csv
message: Import dataset
name: ox
properties:
auth:
example: Bearer <token>
type:
- string
- 'null'
download_url:
example: https://example.com/datasets/data.csv
type: string
email:
example: ox@oxen.ai
type:
- string
- 'null'
filename:
example: data.csv
type:
- string
- 'null'
message:
example: Import dataset
type:
- string
- 'null'
name:
example: ox
type:
- string
- 'null'
required:
- download_url
title: ImportFileBody
type: object
securitySchemes:
authorization:
scheme: bearer
type: http