---
title: "Complete CLI authentication"
method: POST
path: "/auth/cli/complete"
tags: ["CLI Authentication"]
---

# Complete CLI authentication

`POST /auth/cli/complete`

Inspect, claim, or complete a CLI authentication session

## Request body

- object
  - `login_code` string, required
  - `mode` 'check' | 'claim-anon-session' | 'complete'
  - `refresh_token` string

## Response `200`

Successful response

- object
  - `success` boolean, required

## Changes

- **2026-05-15** `f6aec844c9f2` — 1 breaking, 3 info
  - request property `mode` was restricted to a list of enum values
  - added the new `check` enum value to the request property `mode`
  - added the new `claim-anon-session` enum value to the request property `mode`
  - added the new `complete` enum value to the request property `mode`
- **2026-05-06** `e832ef1d24dc` — 2 info
  - added the new optional request property `mode`
  - the request property `refresh_token` became optional

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/changes/auth/cli/complete/post.md)

---

[API](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3.md) · [All operations](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexclave/hexclave-rest-api-3/revisions/3ced76bb7fd8/schema)