The Analysis resource represents a reproducible analysis of an underlying sample using a strictly versioned analysis job.

Analysis types

The One Codex platform supports several types of analyses including metagenomic (or taxonomic) classification, in silico panels, and alignments. Additional analysis types are planned and will be added to the v1 API over time.

All user-viewable analyses are available via the /api/v1/analyses route, while the /api/v1/classifications, /api/v1/panels, and /api/v1/alignments routes provide listings of a subset of the same analyses with the relevant type. These specific resources provide more detailed information and additional routes, but represent the same underlying execution of a job against a sample.

Analysis resource properties

The below table summarizes all of the properties for the Analysis resource, with the JSON schema type of each property listed below in italics.

$uri
string
Example:

"/api/v1/analyses/a1b2c3d4e5f67890"

analysis_type
string | null
complete
boolean
default:false
created_at
string

Timestamp for when the object was created on the One Codex platform, encoded as a RFC 3339 timestamp.

draft
boolean
default:false
error_msg
string | null
Maximum length: 255
job
object

A reference to the versioned job underlying the analysis, e.g., {"$ref": "/api/v1/jobs/d512cb556241440f"}.

job_args
object

The arguments passed into this analysis (can be null).

sample
object

A reference to the sample underlying the analysis, e.g., {"$ref": "/api/v1/sample/0ee172af60e84f61"}.

success
boolean
default:false
updated_at
string

Timestamp for when the object was last updated, encoded as a RFC 3339 timestamp.