Skip to the page

Poll for the key: authorization_pending, slow_down, access_denied, expired_token, or the key once

POST/v1/agents/delegations/token

Operation 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_..."
}'