---
method: POST
path: /api/devices/register/cancel
auth: none
area: devices
---
<!-- source: internal/handlers/devices.go DeviceHandler.CancelRegistration -->

# Cancel Device Registration

Let the REGISTERING device end its own pairing attempt — the plugin calls this
when the user dismisses its waiting dialog. The `registration_id` is the
bearer credential (same trust as the status poll): a device can only ever
cancel its own registration, and already-claimed registrations are left alone
so their token delivery to the device is never disrupted. Idempotent: the
response is the same whether or not the registration still exists.

**Endpoint**: `POST /api/devices/register/cancel`
**Auth**: Not required (registration UUID bearer, like the status poll)
**Content-Type**: `application/json`

## Request Body

| Field           | Type   | Required | Description                    |
| --------------- | ------ | -------- | ------------------------------ |
| registration_id | string | Yes      | UUID from the register response |

### Example Request

```json example-request
{
  "registration_id": "550e8400-e29b-41d4-a716-446655440000"
}
```

## Response (200 OK)

```json example-response
{
  "message": "registration cancelled"
}
```