Run a workflow
This call runs (executes) a workflow and returns the run ID which you can use to monitor its progress (see Get details of a workflow run).
Request
Example request
Header Fields
Name | Description |
---|---|
X-SBG-Auth-Token required | Your authentication token. |
Content-Type required | Specify: multipart/form-data |
Request body
When running a new workflow via WES on CGC, you need to specify the target project using the
project
parameter. See details below.
Name | Data type | Description |
---|---|---|
workflow_params required | object | Specify the name of the project using the project (required) parameter , e.g. "project": "rfranklin/my-project" .You can also use this parameter to specify the input files: The path to the files can be specified either as a platform-local DRS URI or file ID. Option to specify files via an external DRS URI is coming soon. |
workflow_type required | string | The type of workflow language submitted which is supported by this WES instance. |
workflow_type_version required | string | The version of the workflow language submitted which is supported by this WES instance. |
tags | string | Specify tags. |
workflow_url required | string | This parameter is used for specifying the location of the App, which can be any of the following: App in your project - specify the URL to the app, e.g. sbg://admin/sbg-public-data/topmed-alignment App in the Dockstore - specify the URL to your app in the Dockstore, using the standard HTTP or TRS format * App uploaded via workflow_attachment - specify the relative path to the appropriate attachment, e.g. #/workflow_attachment/0 |
workflow_attachment | Array of strings | The workflow_attachment array may be used to upload the App needed to execute the workflow. |
Example request body
Response
See a list of response codes that may be contained in the body of the response.
Response body
Name | Data type | Description |
---|---|---|
run_id | string | Workflow run ID |
Example response body
Updated less than a minute ago