Scispot API - MANIFESTS (PLATES, BOXES, RACKS) API

Update A Manifest

This endpoint allows users to update an existing manifest, these can include sample assignments, labeling modifications, and tag management across multiple well positions within a single manifest.

Update Operations

This endpoint supports several types of operations that users can perform on manifest wells. Each operation requires specific input parameters depending on the intended action.

Assign Operations must be included under the wells array within the plate object. These operations add or update sample assignments, labels, and tags to specific well positions.

Remove Operations must be included under the removeFromWells array within the plate object. These operations clear existing sample assignments, labels, or tags from specific well positions.

Assignment

Assign operations allow users to add or update well assignments including samples, labels, and tags. Multiple assignment types can be combined in a single well object.

{
  "position": "A1",
  "sample" : {
   "id": "SM000001",
   "labsheet": "Sample Manager"
  },
  "tags": ["PASSED_QC"],
  "label": "SAMPLE"
}

position (string, required): The specified well position

sample (object, required): A dictionary object containing the id of the sample to be assigned and the corresponding origin labsheet.

tags (array, required): An array of string values representing custom metadata tags to associate with the well position.

label (string, required): When assigning a label, valid options include one of "SAMPLE", "POS_CONTROL", "NEG_CONTROL", "BLANK", "STANDARD" or left as an empty "" if no label should be assigned.

Removal

Remove operations allow users to clear existing assignments from well positions. Users can selectively remove samples, labels, or tags from specific wells by specifying which fields to clear.

"removeFromWells" : [
 {
   "position" : "B1",
   "fields" : ["LABEL"]
 },
 {
   "position" : "A4",
   "fields" : ["SAMPLE"]
 }
]

position (string, required): The specified well position.

fields (array, required): An array of strings specifying which types of assignments to remove from the well position. Valid options include "SAMPLE", "LABEL", "TAGS".

Provide one of hrid or uuid. plate must contain wells and/or removeFromWells. Position format must match the manifest plate/box layout.

post/manifest/update

Request

  • Base URL: https://cloudlab.scispot.io
  • URL: https://cloudlab.scispot.io/manifest/update
  • Auth: HTTP bearer

Request body

hridstring
uuidstring

Response

OK

successboolean
messagestring
dataobject
updatedManifestobject

Changes

No recorded changes to this operation across all 1 revision of this API.