Skip to content

api reference

Intended Documentation

API Reference: Audit

Query tenant audit events, verify chain integrity, and export evidence artifacts.

intermediate2 min readimplemented

Query Tenant Audit Events#

GET/tenants/:tenantId/auditRequires auth

Returns audit events for a tenant with offset pagination.

tenantIdstring*Tenant identifier (path param).
correlationIdstringFilter by correlation ID.
eventTypestringFilter by audit event type.
limitnumber1-1000 (default 100).
offsetnumberOffset (default 0).
bash
curl "https://api.intended.so/tenants/tenant_acme_prod/audit?eventType=TOKEN_ISSUED&limit=50" \
  -H "Authorization: Bearer mrt_live_abc123"

Verify Audit Chain Integrity#

GET/tenants/:tenantId/audit/chain-verificationRequires auth

Verifies hash-chain integrity for the tenant audit ledger.

bash
curl "https://api.intended.so/tenants/tenant_acme_prod/audit/chain-verification" \
  -H "Authorization: Bearer mrt_live_abc123"

Generate Intent Evidence Bundle#

GET/tenants/:tenantId/intents/:intentId/evidenceRequires auth

Returns a signed evidence bundle for a specific intent.

bash
curl "https://api.intended.so/tenants/tenant_acme_prod/intents/8aa3f5f6-b1a9-4c5b-a29f-b489f7d0be58/evidence" \
  -H "Authorization: Bearer mrt_live_abc123"

Enterprise Export Jobs#

For formal compliance exports, use enterprise admin export jobs:

  • POST /admin/audit-exports (create export)
  • GET /admin/audit-exports?tenantId=... (list)
  • GET /admin/audit-exports/:id?tenantId=... (status)
  • GET /admin/audit-exports/:id/download?tenantId=... (artifact download)

Create Export Example#

bash
curl -X POST https://api.intended.so/admin/audit-exports \
  -H "Authorization: Bearer mrt_live_abc123" \
  -H "x-tenant-id: tenant_acme_prod" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "tenant_acme_prod",
    "includeAnomalies": true,
    "includeRecommendations": true,
    "from": "2026-03-01T00:00:00Z",
    "to": "2026-03-10T00:00:00Z"
  }'

Next Steps#