Audit logs

Every decision DelegateZero makes is recorded in an audit log. Audit logs capture a snapshot of the decision at the time it was made: the original request, the outcome, the confidence score, the primary reason, and which context entries were consulted.

How decisions work (async)

Because DelegateZero consults your full context library before deciding, processing takes a few seconds. The API is fully asynchronous - your POST request returns immediately with a pending status, and you poll until the decision is ready.

Step 1 - Submit a decision request

Make a POST to /api/v1/decisions as normal. You will get back a 202 Accepted response immediately:

{
  "id": 1842,
  "status": "pending",
  "audit_url": "https://delegatezero.com/app/decisions/1842",
  "public_audit_url": "https://delegatezero.com/audit/a3f9c2..."
}

Step 2 - Poll for the result

Poll GET /api/v1/decisions/{id} every 2-3 seconds using the same API key. When status changes from pending to complete, the full decision is included in the response:

{
  "id": 1842,
  "status": "complete",
  "decision": "execute",
  "confidence": 0.91,
  "reason": "Request aligns with standing approval policy for this vendor tier.",
  "title": "Vendor invoice approval",
  "summary": "Routine invoice approval within pre-authorized spend limits.",
  "response": "Approved. Process payment via standard accounts payable workflow.",
  "audit_url": "https://delegatezero.com/app/decisions/1842",
  "public_audit_url": "https://delegatezero.com/audit/a3f9c2..."
}

Polling example

async function waitForDecision(id, apiKey) {
  while (true) {
    const res = await fetch(`https://delegatezero.com/api/v1/decisions/${id}`, {
      headers: { Authorization: `Bearer ${apiKey}` }
    });
    const data = await res.json();
    if (data.status === 'complete') return data;
    await new Promise(r => setTimeout(r, 2500));
  }
}

Audit URLs

Every decision includes two URLs:

• audit_url - your private dashboard view, requires login
• public_audit_url - a shareable, read-only record that shows the outcome and how the decision was made, with all private details stripped. Safe to send to vendors, partners, or clients.

Public audit records are generated automatically - you do not need to do anything to enable them. You can also view recent public decisions on the DelegateZero audit page.