---
title: "Cli Auth Poll"
method: POST
path: "/v1/auth/cli/poll"
tags: ["auth"]
---

# Cli Auth Poll

`POST /v1/auth/cli/poll`

Poll a CLI session (no auth; the device_code is the bearer secret).

Returns the API key exactly once — on the first poll after approval — then
nulls it and marks the session consumed. Subsequent polls never re-expose
it. Expired/unknown sessions report their status so the CLI can stop.

## Request body

- CliAuthPollRequest
  - `device_code` string, required

## Response `200`

Successful Response

- CliAuthPollResponse
  - `status` string, required
  - `api_key` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)