API Authentication
Authenticate ROOTE API requests and understand optional authentication.
Page actions
Optional authentication for Free Data
Eligible Data operations accept either no credentials or a developer Bearer token. In OpenAPI, optional authentication is represented by both alternatives:
security:
- {}
- bearerAuth: []The published OpenAPI exposes this optional authentication for anonymous Data operations. Operations such as Journey that are not eligible for Free access continue to require bearerAuth.
Bearer authentication
Authorization: Bearer YOUR_API_TOKENAn authenticated request is checked against data:read or journey:read. Missing credentials may select Free access only for explicitly anonymous capabilities. Invalid or revoked credentials never fall back to Free.
Endpoints that explicitly document query-token compatibility may also accept ?token=YOUR_API_TOKEN; Bearer remains the default for persistent integrations.
See Authentication and Credits & Limits.