Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Starting HealthOmics Ready2Run workflows using the API

Focus mode
Starting HealthOmics Ready2Run workflows using the API - AWS HealthOmics

Most of the API operations behave in a similar fashion for Ready2Run workflows and private workflows.

To return a list of available Ready2Run workflows, use list-workflows with the type parameter set to READY2RUN.

aws omics list-workflows --type READY2RUN

After you identify the workflow to run from the list-workflows response, you can use get-workflow with the --id parameter to get more details.

aws omics get-workflow --type READY2RUN --id workflow id

To run a Ready2Run workflow, you can use start-run API operation with the workflow-type parameter set to READY2RUN, as shown in the following example

aws-omics start-run \ --workflow-type READY2RUN \ --workflow-id workflow id \ --output-uri &example-s3-bucket; \ --role-arn arn:aws:iam::1234567892012:role/service-role/OmicsWorkflow-20221004T164236 \ --parameters file:///path/to/parameters.json

To monitor your run, you can use the get-run API operation, as shown.

aws-omics get-run --id run id
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.