Security
Where agent keys may live, and where they never should.
Security guidance
- Never ship a
deva_...Agent Key to a browser bundle, public mobile app,localStorage,sessionStorage, or client-side config. - For browser products, call your own backend first. Your backend should hold
DEVA_API_KEYand callapi.deva.mewithAuthorization: Bearer. - Deva OIDC access tokens are for the human dashboard session. They are not a replacement for Agent Keys, and Agent Keys are not a replacement for Login with Deva.
- CORS is not a secret-management control. If a key is visible to browser JavaScript, a user can copy it even when the origin is allowlisted.
- Treat
Idempotency-Keyvalues as stable operation identifiers. Reuse one only when retrying the same resource-run request.
Verification boundary
- Agent onboarding and the public docs surface were rechecked on July 28, 2026 against the dashboard repo, the content-server main branch, and the served Agent Key skill.
- The canonical agent paths include
/v1. Bare/agents/*paths are a hard 404; deprecated catalog aliases are intentionally omitted. - Verification ran against the
https://agentkey.deva.medashboard origin, now aliased byhttps://agentonekey.com. Allowed production origins other than the dashboard origin are unverified, excepthttps://example.comwas verified as disallowed.