API Reference

REST API endpoints and authentication.

Authentication

All requests use:

  • Authorization: Bearer <apiKey>

Standard Headers

Control behavior and context with these headers:

  • X-Njira-Tier: fast, standard (default), or strong
  • X-Tool-Name: Identifier for the calling tool (e.g., web_search)
  • X-Policy-Id: Specific policy ID to enforce
  • X-Tenant-Id: Tenant ID (Admin-only override)

Correlation Headers

  • x-njira-request-id
  • x-njira-trace-id
  • x-njira-project-id
  • x-njira-env

Endpoints (v0)

POST /v1/enforce

Policy enforcement.

POST /v1/traces/events

Trace event ingest.

POST /v1/traces/flush (optional)

Force flush (server-side).