---
title: "Create a piece of equipment."
method: POST
path: "/v2/equipment"
tags: ["Equipment"]
---

# Create a piece of equipment.

`POST /v2/equipment`

## Headers

- `X-Encircle-Attribution` string
- `X-Encircle-Request` string

## Request body

- object
  - `organization_id` string, uuid, required — A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `equipment_spec_id` string, uuid, required — A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `serial_number` string, nullable, required
  - `is_rental` boolean, required
  - `asset_identifier` string, required

## Response `200`

The created `Equipment`

- object
  - `id` string, uuid, required — A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `organization_id` string, uuid, required — A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `equipment_type` 'air_mover' | 'dehumidifier' | 'air_scrubber' | 'dryer' | 'heater' | 'other', required
  - `equipment_spec_id` string, uuid, required — A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
  - `manufacturer` string, required
  - `model` string, required
  - `serial_number` string, nullable, required
  - `is_rental` boolean, required
  - `asset_identifier` string, required
  - `is_retired` boolean, required
  - `created` string, date-time, required — A [RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) compliant `date-time` string.
  - `currently_placed_in` object
    - `claim_id` integer, required
    - `structure_id` integer, required
    - `room_id` integer, required

## Other responses

- `400` — Error processing request.
- `401` — Authentication error.
- `404` — Requested resource does not exist.

---

[API](https://skmtc.net/encircleapp/apis/encircle-public-api.md) · [All operations](https://skmtc.net/encircleapp/apis/encircle-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/encircleapp/encircle-public-api/versions/0e70222a2c6d/schema)