---
title: "Update a doorlock key."
method: PATCH
path: "/doorlock/v1/keys/{id}"
tags: ["Door Locks"]
---

# Update a doorlock key.

`PATCH /doorlock/v1/keys/{id}`

## Path parameters

- `id` string, required

## Headers

- `x-property-id` string, required

## Request body

- DoorLockKeyUpdateRequestSchema
  - `status` 'processing' | 'completed' | 'failed' | 'deleted', nullable
  - `keyCode` string, nullable
  - `errorMessage` string, nullable

## Response `200`

Updated key.

- DoorLockKeyResponseSchema
  - `keyId` string, required
  - `propertyId` string, required
  - `reservationId` string, required
  - `subReservationId` string, required
  - `issuerId` string, required
  - `guestId` string, nullable
  - `rooms` string[], required
  - `commonRooms` string[], required
  - `startDateTime` string, Y-m-d\TH:i:sP, required
  - `endDateTime` string, Y-m-d\TH:i:sP, required
  - `encoder` string, nullable
  - `keyCode` string, nullable
  - `keyType` string, required
  - `mobileId` string, nullable
  - `externalId` string, nullable
  - `status` string, required
  - `errorMessage` string, nullable
  - `createdAt` string, required
  - `updatedAt` string, nullable

## Other responses

- `400` — Bad Request response
- `404` — Not found response
- `500` — Internal server error

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)