---
title: "Start device sign-in (RFC 8628)"
method: POST
path: "/v1/auth/device"
tags: ["Device sign-in"]
---

# Start device sign-in (RFC 8628)

`POST /v1/auth/device`

## Request

- Base URL: `https://api.dropl.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dropl.io/v1/auth/device`
- Auth: none required

No authentication.

## Request body

- DeviceAuthorizationRequest
  - `client_name` string
  - `device_name` string
  - `scopes` Scope[]: Defaults to every scope.

## Response `200`

Success

- DeviceAuthorizationResponse
  - `device_code` string, required
  - `user_code` string, required
  - `verification_uri` string, uri, required
  - `verification_uri_complete` string, uri, required
  - `expires_in` integer, required
  - `interval` integer, required

## Other responses

- `400`: Validation failed
- `429`: Rate limited

---

[API](https://skmtc.dev/dropl/apis/dropl-public-api.md) · [All operations](https://skmtc.dev/dropl/apis/dropl-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dropl/apis/dropl-public-api/revisions/8a42e1f968d4?raw)