---
title: "Initiate device authorization"
method: POST
path: "/api/agent-auth/device"
---

# Initiate device authorization

`POST /api/agent-auth/device`

## Request

- Base URL: `https://goyondo.run`
- URL: `https://goyondo.run/api/agent-auth/device`
- Auth: none required

Start quick connect. Agents should call this first, then direct the user to verification_uri_complete. Do not start by scraping /connect.

## Request body

- DeviceAuthRequest
  - `agent_name` string, required
  - `requested_scopes` string[], required

## Response `200`

Device authorization request created

- DeviceAuthResponse
  - `user_code` string
  - `verification_url` string, uri
  - `verification_uri_complete` string, uri
  - `device_code` string
  - `expires_in` integer
  - `interval` integer

## Other responses

- `500`: Failed to initiate device auth

---

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