DéjàDéjài
API REFERENCE

The Automated Audit API

Programmatically extract Chain of Custody records, query the Knowledge Graph for regression patterns, and integrate verification gates directly into your CI/CD pipelines.

AUTHENTICATION

Bearer Token

The Déjà API uses Bearer Token authentication. All requests must be made over HTTPS.

Authorization
Authorization: Bearer <YOUR_API_KEY>
CORE RESOURCES

Core Resources

Ingest custom telemetry, query the Knowledge Graph, and orchestrate historical backfills.

1 · TELEMETRY INGESTION
Telemetry Ingestion
Push custom error signals to the Normalization Engine.
Signed Payloads Only
2 · EVIDENCE QUERY
Evidence Query
Query evidence of a fix, not just a graph.
3 · HISTORICAL INDEX
Historical Index
Retroactively index past incidents and fixes.
1. TELEMETRY INGESTION

Push custom error signals to the Normalization Engine.

POST
/v1/telemetry/ingest
Signed Payloads Only
Description
Submit a raw error event for processing. The payload is passed through the Path Sanitizer (1) to strip build artifacts (webpack://, node_modules) and generate a deterministic fingerprint.
Use Case
Integrating a custom internal logging tool or a non-standard language stack.
Rate Limit
10,000 events/second.
Request
HTTP
POST /v1/telemetry/ingest
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
 "service": "auth-api",
 "environment": "production",
 "severity": "error",
 "timestamp": "2025-12-24T15:42:18Z",
 "message": "OAuth timeout",
 "stack_trace": "webpack:///src/login/oauth.ts:142:19 ...",
 "tags": { "region": "us-east-1", "release": "v1.2.3" }
}
2. EVIDENCE QUERY

Evidence Query

Query evidence of a fix, not just a graph.

GET /v1/solutions/{fingerprint}
GET
Description
Returns the Verified Resolution Artifact linked to a specific error fingerprint. Includes the Pull Request ID, Author, and Validation Score.
Response
JSON
{
 "status": "verified",
 "resolution_id": "res_8f92a",
 "author": "sarah.j@company.com",
 "pr_link": "github.com/org/repo/pull/420",
 "validation_score": 98,
 "rate_drop": "94.5%"
}
GET /v1/regressions
GET
Description
List all active incidents that match a previously resolved pattern (i.e., "Zombie Bugs").
Filter
?window=24h?severity=critical
3. ORCHESTRATION

Control the "Time Travel" and Backfill engines.

POST
/v1/historical/index
Description
Manually trigger a Historical Batch Scan (2) for a specific repository. Useful after importing a legacy codebase.
Parameters
start_date, end_date, branch.
Request
HTTP
POST /v1/historical/index
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
 "repo": "github.com/org/repo",
 "branch": "main",
 "start_date": "2023-01-01",
 "end_date": "2025-12-24"
}
ACTIONABLE GOVERNANCE EVENTS

Actionable Governance Events

Subscribe to real-time signals from the Deterministic Engine. Hook these up to PagerDuty to wake someone up if a 'Fixed' bug comes back.

View Event Payload Schemas →
Event Type
Trigger
Payload Includes
resolution.verified
Gate passed (Error rate drops > 90%). (3)
PR ID, Error Signature, Time-to-Resolution.
resolution.rejected
Gate failed (e.g., Regression detected). (4)
Original Fix ID, Regressing Commit, "Score: -100".
compliance.breach
Integrity violation (e.g., Minified payload received). (5)
Payload type, rejection reason, incident ID.
  1. (1) Path Sanitizer strips build artifacts (e.g., webpack://, node_modules) and normalizes file paths to generate a canonical fingerprint.
  2. (2) Historical Batch Scan scans a repository over a selected range to populate shadow matches and backfill the Knowledge Graph.
  3. (3) solution.verified triggers when the Rate Gate passes (post-merge error rate drops beyond threshold and minimum traffic criterion is satisfied).
  4. (4) regression.detected triggers when a validated fix is reverted or a previously resolved fingerprint reappears.
  5. (5) alert.predictive triggers when a cross-service match is detected and a preventative fix can be broadcast.
CI/CD GATEKEEPERS

CI/CD Gatekeepers

Don't change your app code. Drop our verification steps into your deployment pipeline to block builds that fail the 'Chain of Custody' check.

GitHub Actions
deja-verify-action
GitLab Runners
deja-verify-job
Jenkins Plugins
deja-compliance-gate
AUDIT CERTIFICATE

Audit Certificate Endpoint

Returns a cryptographically signed JSON object linking the Crash ID, the Commit SHA, and the Verification Timestamp.

GET /v1/audit/certificate/{incident_id}
GET
Description
The "Print Receipt" button for the Auditor. Returns a cryptographically signed JSON object linking the Crash ID, the Commit SHA, and the Verification Timestamp.
RATE LIMITS

Evidence Extraction: Unlimited Throughput

We do not throttle audit requests. Auditors hate rate limits. Tell them the door is always open.

Ready to ingest custom telemetry?

Use the /events endpoint to push signals from IoT, mobile, or on-prem environments.

View Code Examples