# Ratify
> Governed workflow engine for AI agents with human-in-the-loop approvals.

## What is Ratify?
Ratify is a workflow orchestration platform designed specifically for AI agent pipelines. It provides governed, observable, and auditable workflow execution with human approval gates as a first-class primitive.

## Capabilities
- Trigger workflows via webhook, cron schedule, or direct API call
- Multi-step execution with typed connectors: Workers AI, Email, Slack, HTTP, Webhook
- Human and agent approval gates that pause execution at any step
- Step artifacts: named, typed outputs (documents, emails, LLM responses) inspectable by humans and agents
- Real-time run stream via WebSocket
- Full audit trail; replay any run from any step
- Signed URL approvals: agents can resolve approvals without a browser session
- Multi-tenant with per-tenant API key scoping via Unkey

## API
> https://ratify.brian-sandbox.workers.dev/openapi.json

## Docs
> https://ratify.brian-sandbox.workers.dev/docs

## Key endpoints
- POST /v1/runs — trigger a workflow run
- GET /v1/runs/:id — get run status and step details
- GET /v1/runs/:id/stream — WebSocket stream for real-time step updates
- GET /v1/approvals — list pending approvals
- POST /v1/approvals/:id/resolve — resolve an approval (approve or reject)
- GET /v1/approvals/:id/context?token= — get approval context via signed URL (no auth required)
- POST /v1/approvals/:id/resolve?token= — resolve via signed URL (agent-friendly)
- GET /v1/workflows — list workflow definitions
- POST /v1/workflows — create a workflow definition

## Authentication
All /v1/* routes require: Authorization: Bearer <unkey_api_key>
Approval signed-URL endpoints (/context, /resolve?token=) use HMAC-signed tokens — no API key needed.

## Built on
Cloudflare Workers, Durable Objects, D1, R2, Queues. Global edge deployment, no infra to manage.