renza

API reference / CLI pairing

Poll a CLI pairing

POST/v1/public/auth/cli/poll

Public. The CLI polls with its `device_code`. While the user hasn't acted → `pending`; once approved → `approved` with the one-time `api_key` (the pairing is then consumed); else `denied` / `expired`.

Public — no authentication required. Supports idempotency keys.

Powers the `renza login` browser pairing flow; not called directly.

Body parameters

  • device_codestringrequired

Returns

  • 200The current pairing status (and the key once approved).

Failures use the standard error envelope with a closed set of codes.