API

Private API

Authenticate with a bearer API code and query normalized jobs, organizations, countries, platform stats, and protected ops telemetry through stable JSON routes.

Authenticate with a bearer API code and use `/api/private/jobs`, `/api/private/jobs/[id]`, `/api/private/organizations`, `/api/private/countries`, `/api/private/stats`, and the protected ops routes under `/api/private/ops/*`.

API codes are intended for the owner and explicitly authorized clients. Codes are stored as hashes and can be inserted or rotated with the CLI script in `scripts/create-api-code.mjs`.

Scoped keys are supported: `api_read` for the general private read API, `ops` for the operator surface and ops telemetry, and `all` as an explicit full-access override.