# DelegateZero

> DelegateZero is an API-first decision proxy that represents a user's judgment in situations where human input is normally required. It is not a workflow engine, rules-only automation, or autonomous AI — it acts based on context the user has explicitly provided.

## How It Works

Every decision follows this pattern:
1. A request is submitted via HTTP API (plain language string, required)
2. DelegateZero retrieves relevant stored context (policies, precedents, playbooks, entities, templates)
3. It evaluates the request against that context and returns a structured outcome: `execute`, `draft`, or `escalate`
4. Every decision is fully auditable

DelegateZero is conservative by default. It never silently guesses. If confidence is below threshold, context is missing, or a policy is at risk — it escalates with clear rationale and minimal follow-up questions.

## Context Types

Context is the knowledgebase that drives all decisions. Users load context before decisions are made.

- **Policies** — Hard rules. Always respected. Override all other signals.
- **Precedents** — Past decisions and outcomes that inform patterns.
- **Entities** — People, companies, or systems with associated preferences and context.
- **Playbooks** — Human reasoning for ambiguous or difficult situations.
- **Templates** — Reusable response structures (tone, format, shape).
- **Sources** — Raw reference material (emails, documents, files, webpages). Inform reasoning but do not direct it.

Context is added via the dashboard UI or the `/context` API endpoint. New context is immediately available for decisions.

## API

**Authentication:** Bearer token (API key) via standard HTTP Authorization header.

**POST /api/v1/decisions**
- Required: `request` (plain language string)
- Optional: `context` (object), `instructions` (object), `metadata`, `request_id`
- Instructions can include: `confidence_threshold`, `mode` (auto/execute/draft/escalate), `format` (text/html/json/markdown), `response_schema`, `safety_level`, `tone`, `language`

**Decision response includes:**
- `decision_id`
- `decision` — execute | draft | escalate
- `confidence` — 0 to 1 score
- `reason` — plain language explanation
- `response` — typed output (html, text, markdown, json)
- `audit_url` — link to full decision trace

**POST /api/v1/context**
- Accepts a context object (string + metadata) and optional file attachments
- For context ingestion only — not decision evaluation

**Webhooks**
- Emit `decision.created` events with the full decision payload
- Designed for asynchronous workflows and downstream integrations

## Escalation & Safety

- Confidence below threshold → escalate
- Policy violation risk → escalate
- Missing essential context → escalate
- Escalations include reason and minimum follow-up questions needed to resolve

Confidence thresholds are configurable globally and per request.

## Pricing

- **Starter** — $29/mo — 500 decisions/month — individuals and founders
- **Core** — $99/mo — 5,000 decisions/month — operators and managers
- **Team** — $249/mo — expanded volume — multi-user teams
- All plans include a 7-day free trial. No credit card required to start.

## Use Cases

Approvals (expense, invoice, access), message responses (Slack, email), refund decisions, recruiting screening, scheduling and deadline decisions, scope clarification, routing, and any repeatable but context-dependent decision point.

## What DelegateZero Is Not

- Not a workflow engine with predefined steps
- Not a rules-only system
- Not an autonomous AI that acts without bounds
- Not a free-form chatbot
- Not a replacement for expert judgment in regulated domains (legal, medical, financial)

## Key Docs & Links

- Homepage: https://delegatezero.com
- Documentation: https://delegatezero.com/docs
- API reference: https://delegatezero.com/docs#api
- Context guide: https://delegatezero.com/docs#context
- Sign up: https://delegatezero.com/signup