Skip to the page

Ask an existing person for a key that acts for them (device code: they approve one screen)

POST/v1/agents/delegations

Operation 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
  }
}'