Preferred Header
For most API requests, send the key as a Bearer token:Alternative Header
Some integrations usex-api-key:
Query Parameter
Older REST endpoints also acceptapiKey in the query string:
SDK Authentication
The Plato SDK sends the Bearer header for you.PLATO_API_KEY on the server. Do not expose it in browser JavaScript or mobile apps.
Session Authentication
The profile endpoint uses the signed-in user session instead of an API key. Use session-based endpoints only when the request is being made for a signed-in user. API-key integrations should use the API-key routes documented in this section.Key Safety
- Store API keys in environment variables or a secret manager.
- Do not paste keys into public code, screenshots, support tickets, or docs.
- Rotate keys when a tool owner changes.
- Delete keys that are no longer used.
- Give each key the smallest role that still lets the integration work.