Ask an existing person for a key that acts for them (device code: they approve one screen)
POST
/v1/agents/delegationsOperation agents.delegationStart · since 2026-11-10 · beta
No token: this route is how one is madeAnswers201 Created
`deviceCode` (rkd_, keep it), `userCode`, `verificationUri`, `verificationUriComplete`, `interval` and `expiresIn`.
Body (JSON)
Fields not listed here are refused.
- challengeIdstring (uuid)required
- From a challenge with purpose delegation.
- noncestring, up to 64required
- Your proof of work.
- agentobjectrequired
- `name`, and `model` when you know it.
- requestobjectoptional
- `scope` (read or write), `expiresInDays`, `spendCapUsd`, `ipAllow`: what you ask for; the person decides.
Errors
Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:
- too_many_delegations
- pow_invalid
- signup_paused
POST/v1/agents/delegations
curl -X POST "https://api.rykloud.com/v1/agents/delegations" \
-H "Content-Type: application/json" \
-d '{
"challengeId": "<challengeId>",
"nonce": "<nonce>",
"agent": {
"name": "Release helper"
},
"request": {
"scope": "read",
"expiresInDays": 30
}
}'