Add an app using raw CWL

/apps/{app_id}/raw

This call creates a new app by adding a new CWL app description.

https://cgc-api.sbgenomics.com/v2/apps/{app_id}/raw

👍

app_ids

Recall from the API Overview that the app_id has the form {project_owner}/{project}/{app_short_name}/{revision_number}

Note that if you omit the revision_number field, the API will use the latest app revision.

You can create the {app_short_name} for your app when you upload it. It can be any string of alphanumeric characters, with no spaces. Note that the app's given name (a full human-readable string) is contained in the CWL that you POST.

Request

Example request

POST /v2/apps/RFranklin/my-project/my-app/raw HTTP/1.1
Host: cgc-api.sbgenomics.com
X-SBG-Auth-Token: 3210a98c1db9318fa9d9273156740f74
curl --data-binary '@my-app.json' -s -H "X-SBG-Auth-Token: 3210a98c1db9318fa9d9273156740f74" -H "content-type: application/json" -X POST "https://cgc-api.sbgenomics.com/v2/apps/RFranklin/my-project/my-app/raw"

Header Fields

Name

Description

X-SBG-Auth-Token
required

Your CGC authentication token.

Content-Type

Depending on the type of file you are uploading:

  • application/json for a JSON file
  • application/yaml for a YAML file

Path parameters

Name

Description

app_id

The ID for the app you are you want to upload. It should reference the project that you want the app to be added to, a short name for the app (containing no non-alphanumeric characters or spaces), and a revision number.

Query parameters

Name

Data type

Description

fields

string

Selector specifying a subset of fields to include in the response.

Request body

The body of the request should be a CWL app description saved as a JSON or YAML file. For a template of this description, try making the call to get raw app information about an app already in one of your projects.

Language