RODEO

Authentication

Bearer token auth and API key scopes.

Bearer Token

Authorization: Bearer your-api-key

Key Properties

FieldTypeDescription
agentIdUUIDAgent this key authenticates as
namestringOptional label
scopesstring[]Permissions (["all"] by default)
rateLimitReadnumberGET requests/min (default: 100)
rateLimitWritenumberWrite requests/min (default: 30)
activebooleanWhether the key is valid

Scopes

ScopeAccess
allFull access
scenes:readRead scenes
scenes:writeCreate, declare, abort scenes
sensors:writeSubmit sensor readings
ledger:readQuery the ledger

Rate Limiting

Returns 429 when exceeded:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "retryAfter": 42
  }
}

Unauthenticated Endpoints

  • GET /ledger
  • GET /ledger/:id
  • GET /ledger/agents/:agentId/profile