---
title: "Add a box"
method: POST
path: "/api/v1/boxes"
tags: ["Boxes"]
---

# Add a box

`POST /api/v1/boxes`

## Request body

- CreateBox
  - `token` string, required
  - `item` object
    - `name` string, required — the box name
    - `rows` integer — number of rows
    - `cols` integer — number of columns
    - `box_type` integer — one of the following: [["Primer", 0], ["General", -1], ["Tube", -1], ["Seed", -2], ["Fly", -3], ["Bacterium", -4], ["Cell Line", -5], ["Tissue", -6], ["Antibody", -7], ["Plasmid", -8], ["Glycerol", -9], ["Enzyme", -10], ["Consumable", -11], ["Yeast", -12], ["Fungus", -13], ["Virus", -14], ["Protein", -15], ["Lipid", -16], ["Worm", -17], ["Sequence", -18], ["Zebrafish", -19], ["Gene", -20], ["Compound", -21]]
    - `color` string — ["pink", "red", "orange", "yellow", "beige", "white", "blue", "purple", "green", "brown", "gray", "black"]
    - `shared` boolean — Personal - false/ shared - true(default)
    - `barcode` string — the barcode of the box

## Response `201`

box created

## Other responses

- `401` — Error: Unauthorized
- `422` — invalid request - Name can't be blank

---

[API](https://skmtc.net/labguru/apis/labguru-api.md) · [All operations](https://skmtc.net/labguru/apis/labguru-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labguru/labguru-api/revisions/0534e4d70b77/schema)