Environments
Separate API keys
Create distinct keys (and webhook endpoints) for staging and production.
Scope staging keys narrowly.
Realtime
- Register webhooks or subscribe to SSE in staging first; confirm signature verification and idempotent handlers.
- Plan reconnect behavior for WebSocket clients.
Reliability
- Implement backoff on
429usingRetry-After— see Rate limiting. - Parse RFC 9457 errors; branch on
retryableand stablecodevalues for agent automation. - Monitor error rates and quota headers; alert before hard limits block users.
Security
- Complete the Security practices: no keys in clients, no credential logging, least-privilege scopes.
Launch
- Roll out to a small cohort of creators before full traffic.
- Keep a runbook for reconnecting accounts when sessions expire.
- Document which surface each team owns (SDK vs hosted REST vs MCP).