---
title: "Create CLI authentication request"
method: POST
path: "/api/cli/auth"
tags: ["CLI"]
---

# Create CLI authentication request

`POST /api/cli/auth`

## Request

- Base URL: `https://intentdocs.com`
- URL: `https://intentdocs.com/api/cli/auth`
- Auth: none declared

Start the CLI login flow by creating a pending authentication request. Returns a code that the CLI displays to the user for browser-based approval.

## Response `200`

Authentication request created successfully

- object
  - `code` string, required: One-time code for CLI polling (expires in 10 minutes)

---

[API](https://skmtc.dev/intentdocs/apis/intentdocs-api.md) · [All operations](https://skmtc.dev/intentdocs/apis/intentdocs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/intentdocs/apis/intentdocs-api/revisions/28abdea021d0?raw)
