---
title: "Changes to Provision a new device"
method: POST
path: "/devices"
---

# Changes to Provision a new device

`POST /devices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 68 revisions.

- **2026-10-27** `48232fb8589b`: 1 info
- **2026-10-16** `4ad548c528a8`: 5 breaking, 10 info
- **2026-08-13** `02da4f9ce3fd`: 1 breaking, 2 info
- **2026-08-01** `cd80ab1b29b0`: 1 info
- **2026-08-01** `3183ec3153d1`: 1 breaking
- **2026-07-24** `618bd1cc1aed`: 1 breaking, 1 info
- **2026-07-09** `71a7f6cf59a1`: 1 info
- **2026-07-07** `d5d1e5ee8188`: 3 info
- **2026-06-29** `3cb3612f45e0`: 1 info
- **2026-06-29** `8ea6db3daeac`: 1 breaking
- **2026-05-20** `c58d5a5be980`: 1 breaking
- **2026-05-11** `12719a46e639`: 2 info
- **2026-05-08** `8cacdbf9c6f5`: 1 info

## Changes

- **2026-10-27** `48232fb8589b`: 1 info
  - added the new optional `query` request parameter `template`
- **2026-10-16** `4ad548c528a8`: 5 breaking, 10 info
  - removed the enum value `android_cloud_phone` from the `query` request parameter `deviceType`
  - removed the enum value `dedicated_emulated_device` from the `query` request parameter `deviceType`
  - removed the enum value `dedicated_ios_device` from the `query` request parameter `deviceType`
  - removed the enum value `dedicated_physical_device` from the `query` request parameter `deviceType`
  - removed the enum value `dedicated_premium_device` from the `query` request parameter `deviceType`
  - the endpoint scheme security `bearerAuth` was removed from the API
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the non-success response with the status `400`
  - added the non-success response with the status `402`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the non-success response with the status `422`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the required property `platform` to the response with the `200` status
- **2026-08-13** `02da4f9ce3fd`: 1 breaking, 2 info
  - removed the enum value `ios_simulator` from the `query` request parameter `deviceType`
  - added the new enum value `android_cloud_phone` to the `query` request parameter `deviceType`
  - added the new enum value `dedicated_physical_device` to the `query` request parameter `deviceType`
- **2026-08-01** `cd80ab1b29b0`: 1 info
  - endpoint added
- **2026-08-01** `3183ec3153d1`: 1 breaking
  - api path removed without deprecation
- **2026-07-24** `618bd1cc1aed`: 1 breaking, 1 info
  - removed the enum value `dedicated_physical_device` from the `query` request parameter `deviceType`
  - added the new optional request property `proxy/connect`
- **2026-07-09** `71a7f6cf59a1`: 1 info
  - added the new enum value `ios_simulator` to the `query` request parameter `deviceType`
- **2026-07-07** `d5d1e5ee8188`: 3 info
  - added the optional property `createdBy` to the response with the `200` status
  - added the optional property `ownerId` to the response with the `200` status
  - response property `userId` deprecated
- **2026-06-29** `3cb3612f45e0`: 1 info
  - endpoint added
- **2026-06-29** `8ea6db3daeac`: 1 breaking
  - api path removed without deprecation
- **2026-05-20** `c58d5a5be980`: 1 breaking
  - removed the enum value `dedicated_emulated_device` from the `query` request parameter `deviceType`
- **2026-05-11** `12719a46e639`: 2 info
  - api tag `Devices` added
  - api tag `devices` removed
- **2026-05-08** `8cacdbf9c6f5`: 1 info
  - added the new optional `query` request parameter `profileId`

---

[Operation](https://skmtc.dev/droidrun/apis/droidrun-cloud/docs/devices/post.md) - [API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [Page](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/devices/post)