Skip to main content
The Synthesis API uses three authentication methods depending on the type of request.

Project API key

Backend account management via X-PROJECT-API-KEY header. Create accounts, sessions, and API keys.

Account session

Frontend user auth via Authorization: Bearer header. Short-lived, refreshable tokens.

Account API key

Backend user operations via X-API-KEY header. Long-lived, revocable keys.

​
Quick reference

Auth MethodHeaderUse CaseRoutes
Project API KeyX-PROJECT-API-KEYBackend account management/api/v1/project/*
Session TokenAuthorization: Bearer ...Frontend user authentication/api/v1/account/*, /api/v1/wallet/*
Account API KeyX-API-KEYBackend user operations/api/v1/account/*, /api/v1/wallet/*