---
title: "Attach equipment to an estate (nested route)"
method: POST
path: "/places/{place_id}/estates/{estate_id}/equipment"
tags: ["Equipment", "Estates"]
---

# Attach equipment to an estate (nested route)

`POST /places/{place_id}/estates/{estate_id}/equipment`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/places/{place_id}/estates/{estate_id}/equipment`
- Auth: HTTP bearer

Links an existing catalogue equipment to the estate, with an optional
quantity, description and recorded condition.

## Path parameters

- `place_id` string, uuid, required
- `estate_id` string, uuid, required

## Request body

- LinkEquipmentDto
  - `equipment_id` string, uuid, required
  - `description` string, nullable
  - `quantity` integer, nullable
  - `condition_status` 'EXCELLENT' | 'GOOD' | 'FAIR' | 'POOR' | 'DAMAGED' | 'NEEDS_REPAIR' | 'BROKEN' | 'MISSING': Condition status for equipment (used in État des Lieux)
  - `condition_notes` string, nullable

## Response `201`

Equipment attached

- EquipmentJunction
  - `equipment_id` string, uuid, nullable
  - `entity_id` string, uuid, nullable
  - `entity_type` 'place' | 'estate' | 'room', nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `description` string, nullable
  - `quantity` integer, nullable
  - `condition_status` 'EXCELLENT' | 'GOOD' | 'FAIR' | 'POOR' | 'DAMAGED' | 'NEEDS_REPAIR' | 'BROKEN' | 'MISSING': Condition status for equipment (used in État des Lieux)
  - `condition_notes` string, nullable: Free-text notes about the equipment condition

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)