Approving submissions

Once you’ve uploaded sequences via the website or API, you will have to approve them before they are fully submitted.

Website

After submitting sequences, you’ll be taken to a page showing the progress of processing every sequence. For each sequence, it will show whether its awaiting processing, being processed, or has finished processing.

Sequences that have finished processing will show different icons to indicate whether there were any issues during the processing.

  • Green checkmark - indicates that processing was entirely successful
  • Yellow checkmark - indicates that processing encountered warnings
  • Red label - indicates that there were errors during processing

We highly recommend checking all sequences with warnings to see if they could be rectified or indicate a larger problem with the data.

You can only approve and release sequences that have yellow or green checkmarks (no warnings or errors, or only errors) - you cannot approve and release sequences with errors.

You can filter the processed sequences to only show those with warnings, errors, or which passed, to help you decide which actions to take.

If see something you’d like to change, or want to try and resolve a warning, you can edit the sequence.

Actioning individual sequences

For each sequence, you have 3 options (2 if the sequence has an error), indicated to the right: release (paper plane), edit (pencil and paper), and discard (waste bin). Clicking on any of these icons for one sequence, will execute the action on that sequence only. When you release or discard a sequence, it will no longer be shown on the page.

Actioning sequences in bulk

You can also take action on multiple sequences at once, using the buttons above the displayed sequences.

Discarding: You can choose to discard either all sequences, or those with errors. If you discard all sequences, you will need to start the submission process over.

Releasing: You can release all valid sequences (those without warnings or errors, and those with warnings), leaving only those with errors.

Once you release your sequences, they will appear on Pathoplexus within a couple minutes.

If you leave any sequences unreleased, you can view, edit, and approve/release (if they have no errors) them at a later time.

You can also always view your released sequences by going to ‘Browse’ in the top-right menu, then selecting the pathogen, then clicking ‘View’.

API

To use the demo instance instead of the main instance, please replace backend.pathoplexus.org with backend-demo.pathoplexus.org.

The following API requests all require an authentication token. Please read Authenticating via API guide for the instructions to obtain the token an include the token in the HTTP header Authorization: Bearer <authentication token>.

You can retrieve a list of uploaded but not released sequences by sending a GET request to the endpoint:

https://backend.pathoplexus.org/<organism>/get-sequences?groupIdsFilter=<group id>&statusesFilter=RECEIVED&statusesFilter=IN_PROCESSING&statusesFilter=HAS_ERRORS&statusesFilter=AWAITING_APPROVAL&warningsFilter=INCLUDE_WARNINGS

The available values for the organism are: cchf, ebola-sudan, ebola-zaire and west-nile. The sequenceEntries field of the returned object contains a list of sequences with their corresponding status:

  • Sequence that are in the status RECEIVED have not yet been processed. This should usually happen within a few minutes.
  • Sequences that are in the status IN_PROCESSING are currently being processed, please wait a few more moments.
  • Sequences that are in the status HAS_ERRORS contain errors. To find out details, we recommend going to the review page on the website: you can find it by going to the Submission Portal and clicking on “Review”.
  • Sequences that are in the status AWAITING_APPROVAL have passed the processing and quality checks and can be approved.

A cURL request could be:

curl -X 'GET' \
  'https://backend.pathoplexus.org/<organism>/get-sequences?groupIdsFilter=<group id>&statusesFilter=RECEIVED&statusesFilter=IN_PROCESSING&statusesFilter=HAS_ERRORS&statusesFilter=AWAITING_APPROVAL&warningsFilter=INCLUDE_WARNINGS' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <authentication token>'

You can either approve selected sequences or approve all sequences that are in the status AWAITING_APPROVAL. To do that, send a POST request to https://backend.pathoplexus.org/<organism>/approve-processed-data with the following request body:

// For a specific list of sequences:
{
  "accessionVersionsFilter": [
    { "accession": "<accession>", "version": <version> },

  ],
  "groupIdsFilter": [<group id>],
  "scope": "ALL"
}

// Or to approve all entries without errors (which may include sequences with warnings):

{
  "groupIdsFilter": [<group id>],
  "scope": "ALL"
}

A cURL request could be:

curl -X 'POST' \
  'https://backend.pathoplexus.org/<organism>/approve-processed-data' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <authentication token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "groupIdsFilter": [<group id>],
  "scope": "ALL"
}'

Further information can be found in our Swagger API documentation.