---
title: "POST /v1alpha1/device"
method: POST
path: "/v1alpha1/device"
tags: ["DeviceService"]
---

# POST /v1alpha1/device

`POST /v1alpha1/device`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/v1alpha1/device`
- Auth: HTTP bearer and API key in header `x-id-api-key`

Add new device for approval flow

## Request body

- Device: Devices used for user approval
  - `id` string: A unique identifier for the Device.
  - `userId` string: User ID associated with the Device.
  - `subscriptionToken` string: Subscription Token for the Device.
  - `name` string: The device human-readable name.
  - `createdAt` string, date-time: The creation time of the Device.

## Response `200`

OK

- Device: Devices used for user approval
  - `id` string: A unique identifier for the Device.
  - `userId` string: User ID associated with the Device.
  - `subscriptionToken` string: Subscription Token for the Device.
  - `name` string: The device human-readable name.
  - `createdAt` string, date-time: The creation time of the Device.

## Other responses

- `default`: Default error response

## Changes

> 18 revisions in range; 7 not diffed.

- **2025-07-28** `63464ebf3f61`: 4 info
  - the request optional property `createdAt` became not read-only
  - the request optional property `id` became not read-only
  - the response optional property `createdAt` became not read-only for the status `200`
  - the response optional property `id` became not read-only for the status `200`

[Operation history](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api/changes/v1alpha1/device/post.md)

---

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