---
title: "POST /devices/{id}/owner"
method: POST
path: "/devices/{id}/owner"
---

# POST /devices/{id}/owner

`POST /devices/{id}/owner`

## Request

- Base URL: `https://api.oximy.com/v1`
- URL: `https://api.oximy.com/v1/devices/{id}/owner`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `Oximy-Version` '2026-06-29'
- `Idempotency-Key` string, required

## Request body

- DeviceOwnerWriteRequest
  - `employee_id` string, nullable, required

## Response `200`

Device owner applied. The canonical device ID may change when restoring a previous registration.

- DeviceOwnerResponse
  - `object` 'device_owner', required
  - `request_id` string, required
  - `as_of` string, date-time, required
  - `data` DeviceOwnerState, required
    - `device_id` string, required
    - `employee_id` string, nullable, required

## Other responses

- `400`: Invalid parameters.
- `401`: Missing or invalid API key.
- `403`: The API key does not have the required scope.
- `404`: The requested resource was not found in the calling key's workspace scope.
- `409`: Conflict or idempotency replay conflict.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error.

## Changes

- **2026-11-04** `6e120b9b5522`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oximy/apis/oximy-public-api/changes/devices/:id/owner/post.md)

---

[API](https://skmtc.dev/oximy/apis/oximy-public-api.md) - [All operations](https://skmtc.dev/oximy/apis/oximy-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oximy/apis/oximy-public-api/revisions/6e120b9b5522?raw)