• Getting Started
• Authentication
• API Documentation
• CLI & Client Library (Python)
• Jupyter Notebooks
• Pagination
• Errors

​

Samples

• The Sample Resource

• Retrieve All Samplesget

• Retrieve A Sampleget

• Retrieve Public Samplesget

• Uploading Samples

  • Starting an Uploadpost
  • Confirming an Uploadpost
  • Pre-Uploading Samplespost

• Updating Samplespatch

• Downloading Sequence Datapost

​

Metadata & Tags

• The Metadata Resource
• The Tag Resource
• Retrieve All Metadataget
• Retrieve A Metadata Recordget
• Retrieve All Tagsget
• Retrieve A Tagget
• Updating Metadatapatch

​

Analyses

• The Analysis Resource
• Retrieve All Analysesget
• Retrieve An Analysisget
• Retrieve Analysis Resultsget
• Retrieve Analysis Filesget
• Retrieve Analysis Output File Detailsget
• The Classification Resource
• Retrieve All Classificationsget
• Retrieve A Classificationget
• Classification Resultsget
• Read-Level Resultsget
• The Panel Resource
• Retrieve A Panelget
• Retrieve All Panelsget
• Panel Resultsget
• The Alignment Resource
• Retrieve All Alignmentsget
• Retrieve An Alignmentget

​

Jobs

• The Job Resource
• Retrieve All Jobsget
• Retrieve A Jobget

​

Documents

• The Document Resource

• Retrieve All Documentsget

• Retrieve A Documentget

• Uploading Documents

  • Starting a Document Uploadpost
  • Confirming a Document uploadpost

• Downloading Documentspost

​

Webhooks & Events

• Using Webhooks
• Checking Signatures
• Retrieve All Eventsget
• Retrieve An Eventget

​

Sequencing

• Sequencing Batches

  • Retrieving All Sequencing Batchesget
  • Retrieving a Sequencing Batchget
  • Registering a Sequencing Batchpost
  • Retrieving Samples in a Sequencing Batchget

​

Uploading Documents

​

Uploading documents

Documents may be uploaded via the REST API or by using the One Codex CLI or Python client library.

The latter two options are simpler and thus recommended. In every case, we replace spaces in filenames with underscores. To upload with the CLI, simply:

# If you haven't previously logged in, the following command
# will prompt you for your username and password and then
# save a ~/.onecodex file with your API key
onecodex login

onecodex documents upload $LIST_OR_GLOB_OF_YOUR_DOCUMENTS

Uploading via the REST API consists of 3 steps:

• (1) Initiating an upload by POSTing to /documents/init_upload
• (2) Uploading the document to the provided upload_url and with any additional_fields provided. See the Starting an Upload documentation for more details.
• (3) Confirming the upload by POSTing to /documents/confirm_upload

​

Documents over 20GB

The above upload mechanisms currently only allow document uploads up to 20GB (optionally compressed with gzip). If you need to upload a compressed file over 20GB, please contact us at [email protected] and we can provide an alternative upload or file import mechanism for your situation.