---
title: "Poll device auth status"
method: POST
path: "/api/auth/device/poll"
tags: ["Auth"]
---

# Poll device auth status

`POST /api/auth/device/poll`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/auth/device/poll`
- Auth: none declared

Poll a pending device authorization flow by `device_code`.

## Request body

- DevicePollRequest
  - `device_code` string, required

## Response `200`

Device flow approved and API key returned.

- DevicePollResponse
  - `status` 'pending' | 'approved' | 'expired' | 'denied' | 'consumed'
  - `api_key` string
  - `key_name` string
  - `customer_id` string
  - `email` string
  - `error` string

## Other responses

- `202`: Device flow still pending.
- `400`: Invalid JSON body.
- `410`: Device flow expired, denied, or already consumed.
- `422`: Missing `device_code`.

---

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