Create Device Code

curl -X POST "https://api.danubeai.com/v1/auth/device/code" \
  -H "Content-Type: application/json" \
  -d '{"client_name": "Claude Code"}'

{
  "device_code": "dc_a1b2c3d4e5f6...",
  "user_code": "ABCD-1234",
  "verification_url": "https://danubeai.com/device",
  "expires_in": 600,
  "interval": 5
}

POST

auth

device

code

curl -X POST "https://api.danubeai.com/v1/auth/device/code" \
  -H "Content-Type: application/json" \
  -d '{"client_name": "Claude Code"}'

{
  "device_code": "dc_a1b2c3d4e5f6...",
  "user_code": "ABCD-1234",
  "verification_url": "https://danubeai.com/device",
  "expires_in": 600,
  "interval": 5
}

Overview

Initiates the device authorization flow for CLI tools and AI agents that cannot open a browser directly. Returns a user code that must be entered at the verification URL to authorize the device. Flow:

Agent calls this endpoint to get a device_code and user_code
User opens verification_url in their browser and enters the user_code
Agent polls Poll Device Token with the device_code
Once authorized, the poll returns an API key

No authentication required.

Body Parameters

client_name

string

default:"Unknown Client"

Name of the client requesting authorization (shown to user during approval)

Response

device_code

string

Opaque code for the agent to use when polling for the token

user_code

string

Human-readable code in XXXX-XXXX format for the user to enter

verification_url

string

URL where the user should enter the code

expires_in

integer

Seconds until the device code expires (600 = 10 minutes)

interval

integer

Minimum seconds between poll requests (5)

Example

curl -X POST "https://api.danubeai.com/v1/auth/device/code" \
  -H "Content-Type: application/json" \
  -d '{"client_name": "Claude Code"}'

{
  "device_code": "dc_a1b2c3d4e5f6...",
  "user_code": "ABCD-1234",
  "verification_url": "https://danubeai.com/device",
  "expires_in": 600,
  "interval": 5
}

Device Auth Flow

Agent                          User                         Danube
  |                              |                            |
  |-- POST /auth/device/code --->|                            |
  |<-- device_code, user_code ---|                            |
  |                              |                            |
  |  "Enter ABCD-1234 at URL"   |                            |
  |----------------------------->|                            |
  |                              |-- Opens verification_url ->|
  |                              |-- Enters user_code ------->|
  |                              |<-- "Authorized!" ----------|
  |                              |                            |
  |-- POST /auth/device/token -->|                            |
  |<-- api_key ------------------|                            |

Get Webhook Deliveries Poll Device Token

​Overview

​Body Parameters

​Response

​Example

​Device Auth Flow

Overview

Body Parameters

Response

Example

Device Auth Flow