---
title: "Start CLI device authorization"
method: POST
path: "/cli/auth/start"
tags: ["Auth"]
---

# Start CLI device authorization

`POST /cli/auth/start`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/cli/auth/start`
- Auth: none required

## Request body

- StartCLIAuthInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `client_name` string, required: CLI client name
  - `client_os` string, required: CLI host operating system
  - `client_version` string, required: CLI client version
  - `requested_scopes` string: Requested API token scope; omitted or cli:full

## Response `200`

OK

- StartCLIAuthOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `device_code` string, required
  - `expires_in` integer, required
  - `interval` integer, required
  - `user_code` string, required
  - `verification_url` string, required

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)