Response object

Every decision request returns a structured response describing what DelegateZero decided, how confident it is, and what it produced as the canonical response.

The response object is designed to be both machine-readable (for automation) and human-reviewable (via the audit log).

Pending response (async mode)

In async mode, the POST returns immediately with HTTP 202 and a pending status. Poll GET /api/v1/decisions/{id} to retrieve the result when ready. See Request object for full cURL, Node.js, and Python polling examples.

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

Complete response

Once the decision is processed (polled via GET, or returned directly in sync mode), the full result looks like this:

{
  "id": 1842,
  "status": "complete",
  "decision": "execute",
  "confidence": 0.86,
  "title": "Monthly analytics email to Jane",
  "summary": "Sent monthly analytics report to Jane at ABC Company covering January performance.",
  "reason": "Email content aligns with the provided analytics data and prior client report templates",
  "response": "Here's your monthly website analytics report for January. Overall traffic increased by 12% month-over-month, driven primarily by organic search. Conversion rate remained steady at 2.4%, with top-performing pages being /pricing and /blog. Notably, paid spend decreased by 8% while total leads increased by 5%. Let me know if you'd like a deeper breakdown or have any questions. Best, Your Team",
  "suggestion": "Adding an entity entry for Jane's company would let DelegateZero tailor tone and detail level to your existing relationship history with this client.",
  "audit_url": "https://delegatezero.com/app/decisions/1842",
  "public_audit_url": "https://delegatezero.com/audit/a3f9c2..."
}

If your request contained response_schema values, the response will be structured into named fields under response_schema:

{
  "id": 1842,
  "status": "complete",
  "decision": "execute",
  "confidence": 0.86,
  "reason": "Email content aligns with the provided analytics data and prior client report templates",
  "response_schema": {
    "subject": "ABC Company - Monthly Analytics Update",
    "email": "jane@abccompany.com",
    "text": "Here's your monthly website analytics report for January..."
  },
  "suggestion": "",
  "audit_url": "https://delegatezero.com/app/decisions/1842",
  "public_audit_url": "https://delegatezero.com/audit/a3f9c2..."
}

Response properties

• id: A unique identifier for the decision. Use this to poll for status or reference the decision in downstream systems.
• status: pending while the decision is being processed, complete when ready.
• decision: Indicates how DelegateZero handled the request. Possible values are execute (action taken automatically), draft (output generated but not executed), or escalate (human review required).
• confidence: A number between 0 and 1 representing how confident DelegateZero is that the decision and response match your expected judgment.
• title: A short noun phrase (5 words max) describing the decision. Useful for display in dashboards or notification summaries.
• summary: A one to two sentence internal summary of the request and outcome, written for human review.
• reason: A plain-text explanation describing why the decision was made, what context influenced it, and what gaps (if any) affected confidence.
• suggestion: A single, specific recommendation generated after the decision is evaluated. Points forward only — never comments on the current result. Empty string if nothing meaningful to surface for this request.
• response: The canonical output produced by DelegateZero for this request. This represents what DelegateZero would send or do on your behalf.
• response_schema: An optional object containing a structured split of the response into named fields. Returned only when requested via instructions.response_schema.
• audit_url: A URL linking to the private audit log for this decision in your dashboard.
• public_audit_url: A shareable, read-only link showing how the decision was made, with all private details removed. Safe to send to vendors, partners, or clients.