{
"$uri": "/api/v1/documents/0d77065796f8d173",
"created_at": "2023-11-07T05:31:56Z",
"downloaders": [
{
"__DOLLAR_REF__": "/api/v1/users/a1b2c3d4e5f67890"
}
],
"filename": "<string>",
"size": 2,
"uploader": {
"__DOLLAR_REF__": "/api/v1/users/a1b2c3d4e5f67890"
}
}Documents
The Document Resource
A Document is a file of any type that might be associated with a Sample or Analysis. Examples of such files include: FAST5 files form Oxford Nanopore, PDF reports generated by our notebook service, and Excel spreadsheets containing metadata.
Documents uploaded to One Codex are stored securely and can be shared with members of your organization. Uploading Documents requires two direct API calls: one to start the upload, and one to confirm that the upload succeeded. If you need to upload a compressed file over 20GB in size, please contact us for help at support@onecodex.com.
The below table summarizes all of the properties for the Document resource, with the JSON schema type of each property listed below in italics. Details on how to upload, modify, and retrieve Documents follow.
Pattern:
^/api/v1/documents/[a-f0-9]{16}$Example:
"/api/v1/documents/0d77065796f8d173"
An (optionally empty) array of references to users that the document has been shared with. These users are able to download (but not modify) the document.
Show child attributes
Show child attributes
The document filename (e.g., "report.pdf")
The size of the document in bytes.
Required range:
x >= 1A reference to the user that uploaded and owns the document, e.g., {"$ref": "/api/v1/users/5891ee65711c4d5e"}. Only owners can modify a document (with some exceptions in the case of organization accounts configured for multiple users - please contact us if you'd like to discuss this use case).
Show child attributes
Show child attributes
⌘I