Poll for the key: authorization_pending, slow_down, access_denied, expired_token, or the key once
POST
/v1/agents/delegations/tokenOperation agents.delegationToken · since 2026-11-10 · beta
No token: this route is how one is madeAnswers200 OKanswers a secret
The key once (`key.secret`, rka_) and the agent.
Poll every `interval` seconds; slow_down means wait longer.
This answer holds a secret
It is sent with
cache-control: no-store and every call is recorded in the organisation's activity. Do not log it.Body (JSON)
Fields not listed here are refused.
- deviceCodestringrequired
- From agents.delegationStart.
Errors
Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:
- authorization_pending
- slow_down
- access_denied
- expired_token
POST/v1/agents/delegations/token
curl -X POST "https://api.rykloud.com/v1/agents/delegations/token" \
-H "Content-Type: application/json" \
-d '{
"deviceCode": "rkd_..."
}'