Skip to main content
POST
/
v1
/
oauth
/
device
/
start
/
{provider}
Begin a device-code OAuth flow (e.g. OpenAI Codex)
curl --request POST \
  --url https://auth.runtools.ai/v1/oauth/device/start/{provider} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "provider": "<string>",
    "authType": "device_code",
    "attemptToken": "<string>",
    "verificationUri": "<string>",
    "verificationUriComplete": "<string>",
    "userCode": "<string>",
    "interval": 123,
    "expiresAt": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.runtools.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

WorkOS session token or RunTools API key (rt_live_* / rt_test_*). Used in Authorization: Bearer <token> header.

Path Parameters

​
provider
enum<string>
required
Available options:
openai-codex

Response

200 - application/json

Device flow started.

​
data
object