---
title: "Start device auth flow"
method: POST
path: "/api/auth/device/start"
tags: ["Auth"]
---

# Start device auth flow

`POST /api/auth/device/start`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/auth/device/start`
- Auth: none declared

Begin CLI device authorization flow.

No authentication required. Rate limited to 10 requests/minute/IP.

## Response `200`

Device flow started.

- DeviceStartResponse
  - `device_code` string
  - `user_code` string
  - `verification_url` string, uri
  - `expires_in` integer
  - `interval` integer

## Other responses

- `429`: Rate limit exceeded.
- `500`: Device flow could not be created.

---

[API](https://skmtc.dev/agenticcom/apis/colter-public-api.md) · [All operations](https://skmtc.dev/agenticcom/apis/colter-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcom/apis/colter-public-api/revisions/c86a6b9228f0?raw)