---
title: "Update box attributes"
method: PUT
path: "/api/v1/boxes/{id}"
tags: ["Boxes"]
---

# Update box attributes

`PUT /api/v1/boxes/{id}`

## Path parameters

- `id` integer, required

## Request body

- UpdateBox
  - `token` string, required
  - `item` object
    - `name` string — 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 `200`

box updated

## Other responses

- `401` — Error: Unauthorized
- `422` — invalid request

---

[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)