Create Location

POST

https://{tenant_name}.benchling.com/api/v3/location

POST

/api/v3/location

curl -X POST https://{tenant_name}.benchling.com/api/v3/location \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "name",
  "schemaId": "schemaId"
}'

{
  "__typename": "__typename",
  "creator": {
    "__typename": "__typename",
    "id": "id"
  },
  "schemaFields": [
    {
      "__typename": "__typename",
      "id": "id",
      "linkedEntityId": "linkedEntityId"
    }
  ],
  "allowNonLocationChildren": true,
  "allowedInventorySchemas": [
    {
      "__typename": "__typename",
      "id": "id"
    }
  ],
  "archiveReason": "archiveReason",
  "archived": true,
  "availableCapacity": 1,
  "barcode": "barcode",
  "createdAt": "createdAt",
  "id": "id",
  "modifiedAt": "modifiedAt",
  "name": "name",
  "occupiedCapacity": 1,
  "parentStorage": {
    "__typename": "__typename",
    "id": "id"
  },
  "schema": {
    "__typename": "__typename",
    "id": "id"
  },
  "totalCapacity": 1,
  "validationStatus": "PASSED"
}

Create Location.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired

schemaIdstringRequired

barcodestringOptional

parentStorageIdstringOptional

schemaFieldsmap from strings to objectsOptional

Response

Created

__typenamestringOptional

creatorobject or nullOptional

schemaFieldslist of objects or nullOptional

allowNonLocationChildrenbooleanOptional

Whether this location can store plates, boxes, and containers.

allowedInventorySchemaslist of objectsOptional

The plate, box, and container schemas that can be stored in this location. If allowsNonLocationChildren is true and this list is empty, all schemas are allowed.

archiveReasonstring or nullOptional

archivedbooleanOptional

availableCapacityinteger or nullOptional

The number of available positions in this location. Null if totalCapacity is not set.

barcodestring or nullOptional

createdAtstring or nullOptional

idstringOptional

modifiedAtstring or nullOptional

namestring or nullOptional

occupiedCapacityinteger or nullOptional

The number of plates, boxes, and containers currently in this location. Null if totalCapacity is not set.

parentStorageobject or nullOptional

schemaobject or nullOptional

totalCapacityinteger or nullOptional

The total capacity of this location (i.e. how many plates, boxes, and containers it can store). If null, capacity is not limited.

validationStatusenumOptional

Whether this location is passing all validation checks.

Allowed values:

Errors

400

Location Create Request Bad Request Error

403

Location Create Request Forbidden Error

404

Location Create Request Not Found Error

409

Location Create Request Conflict Error

429

Location Create Request Too Many Requests Error

500

Location Create Request Internal Server Error