Purpose
The authentication and scope model the API must have before the intelligence surface publishes for external integrations.What is required before this publishes
- API-key or OAuth client-credentials auth, replacing first-party login JWTs.
- Scopes, at minimum:
readwritedestructivebilling/comms-impacting, for operations that spend money or message candidates (phone calls, AI interviews, invite sends)
- Per-key rate limits and quotas across every published endpoint, at parity with the protections already enforced on Exterview’s other production services (request throttling, quota headers, idempotency keys).
- Per-organization data-access controls enforced at the API gateway for every published operation.
- GraphQL versioning and a deprecation policy.
- DPA and legal sign-off for any operation returning candidate PII (reports, transcripts, recordings).
Scope-gated operations
Some operations are scoped even once auth exists:The Career Page capability is exempt. It is
public and unauthenticated by design.
Tracking
Progress against this checklist is tracked internally. Nothing in the Capabilities section of this site goes live until every box is checked.FAQs
Can we integrate with the API today?
Can we integrate with the API today?
Not as a partner. The only credential today is a first-party login token. API-key or OAuth client-credentials auth is required first.
What scopes will exist?
What scopes will exist?
At minimum
read, write, destructive, and billing/comms-impacting, plus
decisions:write for decision overrides.Why are some operations scope-gated?
Why are some operations scope-gated?
Because they spend money, message candidates, or change the hiring audit
trail. Those are never in the default read tier.
Is anything public without auth?
Is anything public without auth?
Yes, the Career Page. Every other capability sits behind this checklist.
Related
Developer Preview
How the API is shaped, scoped, and planned to work.

