---
title: "Create a key set for an inventory item"
method: POST
path: "/inventory/{inventoryId}/keyset"
tags: ["Inventory"]
---

# Create a key set for an inventory item

`POST /inventory/{inventoryId}/keyset`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/inventory/{inventoryId}/keyset`
- Auth: `appAuth` (a scheme the document does not define)

## Path parameters

- `inventoryId` string, required

## Headers

- `AgencyRef` string, required

## Request body

- AltoInventoryApiModelsRequestsAddKeySetRequest
  - `referenceCode` string, nullable
  - `description` string, nullable
  - `keyCount` integer
  - `status` 'Unspecified' | 'In' | 'Out' | 'Lost' | 'Returned'
  - `notes` string, nullable
  - `expectedDateIn` string, date-time, nullable
  - `holderType` 'Contact' | 'User', nullable
  - `holderId` integer, nullable

## Response `201`

Returns the created key set

- AltoInventoryApiDomainAltoKeySet
  - `id` integer
  - `propertyId` integer
  - `referenceCode` string, nullable
  - `description` string, nullable
  - `keyCount` integer
  - `status` 'Unspecified' | 'In' | 'Out' | 'Lost' | 'Returned'
  - `notes` string, nullable
  - `dateOut` string, date-time, nullable
  - `expectedDateIn` string, date-time, nullable
  - `holderType` 'Contact' | 'User', nullable
  - `holderId` integer, nullable
  - `holderName` string, nullable

## Other responses

- `400`: When the request does not contain the expected information
- `401`: When access has not been granted
- `404`: The inventory was not found

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)