RaylightAPI

API keys

Start a device-code key request

Public. Returns a device code to poll with and an approval URL to show the user. Pick a name that says who is asking.

POST/v1/keys/request

Public. No API key needed.

Request body

application/json

FieldTypeDescription
namestringDefault API key

Responses

201The pairing.
400Invalid body.
429Rate limited: 60 requests a minute per address. Carries Retry-After.

201 response body

FieldTypeDescription
deviceCoderequiredstring
userCoderequiredstring
approvalUrlrequiredurl
expiresInSecondsrequiredinteger
pollIntervalSecondsrequiredinteger

Example

curl
curl -X POST https://api.raylight.app/v1/keys/request \  -H "Content-Type: application/json" \  -d '{ "name": "CI on acme/web" }'