← Back to reference

Rest Api Reference

Base URL: https://api.denpex.ai/v1/<tenant_id>/...

All endpoints require:

  • Authorization: Bearer <token>
  • X-Denpex-Tenant: <tenant_id>
  • TLS 1.3 only.

Endpoints

Incidents

MethodPathDescription
GET/incidents/:idRetrieve
POST/incidentsOpen a new (manual) incident
POST/incidents/:id/approveApprove a remediation
POST/incidents/:id/dismissMark as false positive
GET/incidents/:id/graphGet the evidence graph
GET/incidents/:id/timelineGet the timeline

Diagnostics

MethodPathDescription
GET/diagnostics/:id/relatedSimilar incidents

Remediation

MethodPathDescription
POST/remediation/:id/rollbackRoll back

Audit

MethodPathDescription
GET/audit/verifyRun hash-chain verifier
GET/audit/exportStream to external SIEM

RBAC

MethodPathDescription
POST/rbac/roleCreate role
POST/rbac/bindBind role to principal

Tenants (Platform)

MethodPathDescription
POST/platform/tenants/:idCreate tenant

Status Codes

  • 200 OK — success.
  • 201 Created.
  • 204 No Content.
  • 400 Bad Request — malformed input.
  • 401 Unauthorized — missing/invalid token.
  • 403 Forbidden — RBAC denial.
  • 404 Not Found.
  • 409 Conflict — state mismatch.
  • 422 Unprocessable — semantic error.
  • 429 Too Many Requests — rate limit hit; Retry-After provided.
  • 500 Internal Server Error.
  • 503 Service Unavailable.

Rate Limits

  • Free: 5 RPS.
  • Team: 50 RPS.
  • Scale: 200 RPS.
  • Growth: 1000 RPS.

Pagination

?limit=...&after=...

after is an opaque cursor returned in next_after from the prior response.

Idempotency

Idempotency-Key: <uuid> is supported on POST endpoints. The same key returns the same response for 24h.