# AgentFax

AgentFax is a fax API designed for AI agents and workflow automation.

Base API: https://agentfax-api.scshome.workers.dev
Docs: https://agentfax.pages.dev/docs/
OpenAPI: https://agentfax-api.scshome.workers.dev/openapi.json

Core actions:
- POST /v1/faxes sends or dry-runs a fax.
- GET /v1/faxes/{fax_id} retrieves delivery state.
- POST /v1/faxes/{fax_id}/cancel attempts cancellation.
- POST /v1/webhooks registers a signed customer webhook endpoint.
- POST /billing/onboarding creates a pending account and Checkout URL.
- POST /billing/claim verifies completed Checkout and returns the first API key once.

Rules for agents:
- Use Idempotency-Key for retries.
- Use dry_run=true before sending regulated or high-value documents.
- Prefer media_url for live fax sending.
- Poll GET /v1/faxes/{fax_id} or listen for AgentFax webhooks.