# Start a device authorization (RFC 8628) (/docs/api-reference/api/v1/auth/device/post)

`POST https://mmb-blurware-alpha.vercel.app/api/v1/auth/device`

Start a device authorization (RFC 8628)

Begins the CLI login flow. Show the user_code and verification_uri to the user, then poll POST /api/v1/auth/device/token.

Operation ID: `deviceStart`

OpenAPI document: https://mmb-blurware-alpha.vercel.app/openapi.json

## Authentication

Public endpoint; no bearer token is required.

## Request

This operation has no request parameters or body.

## Responses

### `200` — Device authorization created.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "device_code": {
      "type": "string",
      "description": "Secret polling credential. Never display it."
    },
    "user_code": {
      "type": "string",
      "description": "Short code the user enters at the verification URI."
    },
    "verification_uri": {
      "type": "string",
      "description": "Absolute URL where the user approves the device."
    },
    "expires_in": {
      "type": "number",
      "description": "Seconds until this authorization expires."
    },
    "interval": {
      "type": "number",
      "description": "Minimum polling interval in seconds."
    }
  },
  "required": [
    "device_code",
    "user_code",
    "verification_uri",
    "expires_in",
    "interval"
  ]
}
```

### `429` — Too many requests. Mirrors the Retry-After header.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "rate_limited"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```

### `503` — The gateway is unreachable.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "service_unavailable"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```