---
title: "Create device signing challenge"
method: POST
path: "/v1/mfa/challenges/devices"
tags: ["Device signing challenges"]
---

# Create device signing challenge

`POST /v1/mfa/challenges/devices`

This endpoint creates a new device signing 2FA challenge on a customer's device. The customer must already have registered the device using the device binding process.

## Request body

- object
  - `device_id` string — The ID of the customer's previously registered/bound device.
  - `key_purpose` '' | 'unrestricted' | 'restricted' — (Optional) Specifies the type of key to be used for signing the device challenge (restricted or unrestricted). Please note the following: - If you do not enter a value here, then the key will be chosen using pre-defined strategy. - If a device has more than one registered key pair, the default value would be `unrestricted`.
  - `device_data` string — Base64 encoded device data as provided by Seon SDK. Details of Seon SDK integration can be found in the [device monitoring guide](https://docs.solarisgroup.com/guides/kyc/device-monitoring/).

## Response `201`

Created

- DeviceChallenge — Helper sub-schema that contains a common set of fields for various challenge types
  - `id` string — The ID of the challenge.
  - `type` string — The type of the challenge.
  - `created_at` string — The date and time when the challenge was created.
  - `expires_at` string — The date and time when the challenge will expire (i.e., 5 minutes after creation).
  - `string_to_sign` string — The string to be signed by the customer's device using its generated key pair.

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflicts
- `500` — Internal server error

---

[API](https://skmtc.net/solarisgroup/apis/device-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/device-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/device-management/revisions/80dd46738839/schema)