ROOTEDocs
ROOTE API

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_TOKEN

An 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.

On this page