---
title: "api/hives POST
Store a newly created Hive in storage for the authenticated user."
method: POST
path: "/api/hives"
tags: ["Api\\HiveController"]
---

# api/hives POST
Store a newly created Hive in storage for the authenticated user.

`POST /api/hives`

## Headers

- `Authorization` string
- `Content-Type` string
- `Accept` string
- `Accept-language` string

## Request body

- object
  - `name` string, required
  - `location_id` integer, required
  - `brood_layers` integer — Het value veld is verplicht wanneer <code>layers</code> niet aanwezig is. value dient minimaal 0 te zijn.
  - `honey_layers` integer — Het value veld is verplicht wanneer <code>layers</code> niet aanwezig is. value dient minimaal 0 te zijn.
  - `frames` integer — value dient minimaal 0 te zijn.
  - `order` integer
  - `layers` string[] — Het value veld is verplicht wanneer geen van <code>brood_layers</code> and <code>honey_layers</code> aanwezig is.
  - `color` string — value mag niet groter zijn dan 9 karakters.
  - `hive_type_id` integer
  - `bb_width_cm` number — value dient minimaal 0 te zijn.
  - `bb_depth_cm` number — value dient minimaal 0 te zijn.
  - `bb_height_cm` number — value dient minimaal 0 te zijn.
  - `fr_width_cm` number — value dient minimaal 0 te zijn.
  - `fr_height_cm` number — value dient minimaal 0 te zijn.
  - `queen` object
    - `race_id` integer
    - `birth_date` string — value is geen geldige datum.
    - `name` string
    - `description` string
    - `line` string
    - `tree` string
    - `color` string — value mag niet groter zijn dan 9 karakters.
    - `clipped` integer
    - `fertilized` integer
  - `timezone` string — Must be a valid time zone, such as <code>Africa/Accra</code>.

## Changes

> 15 revisions in range; 1 could not be searched.

- **2022-06-24** `ec6784720a6f` — 5 info
  - the `bb_depth_cm` request property type/format was generalized from `integer`/`` to `number`/``
  - the `bb_height_cm` request property type/format was generalized from `integer`/`` to `number`/``
  - the `bb_width_cm` request property type/format was generalized from `integer`/`` to `number`/``
  - the `fr_height_cm` request property type/format was generalized from `integer`/`` to `number`/``
  - …1 more
- **2022-06-20** `0f012f9da8ca` — 1 breaking
  - the `layers` request property type/format changed from `string`/`` to `array`/``
- **2022-06-20** `a87569f002e1` — 1 warning, 20 info
  - removed the request property `queen/created_at`
  - added the new optional `header` request parameter `Accept-language`
  - added the new optional request property `bb_depth_cm`
  - added the new optional request property `bb_height_cm`
  - …17 more
- **2022-06-10** `568ca15f3476` — 20 warning, 1 info
  - deleted the `header` request parameter `Accept-language`
  - removed the request property `bb_depth_cm`
  - removed the request property `bb_height_cm`
  - removed the request property `bb_width_cm`
  - …17 more

[Change history](https://skmtc.dev/beepnl/apis/beep/changes/api/hives/post.md)

---

[API](https://skmtc.dev/beepnl/apis/beep.md) · [All operations](https://skmtc.dev/beepnl/apis/beep/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beepnl/beep/revisions/7f1e35deb524/schema)