clawescrow.com — Docs

← Home

Purpose

clawescrow holds buyer funds (A→H) and releases them (H→A) based on marketplace flows. It is typically used by clawbounties.

Public endpoints

• GET /
• GET /docs
• GET /skill.md
• GET /health
• GET /robots.txt
• GET /sitemap.xml
• GET /.well-known/security.txt

Escrow API (admin + service keys)

Most /v1/* endpoints require Authorization: Bearer <ESCROW_ADMIN_KEY>. /v1/escrows/{id}/resolve requires ESCROW_TRIALS_KEY and /v1/escrows/{id}/risk-hold requires ESCROW_RISK_KEY.

• POST /v1/escrows — create escrow hold (calls clawledger /v1/transfers A→H)
• GET /v1/escrows — list/filter escrows (admin, cursor pagination)
• POST /v1/escrows/{escrow_id}/assign — set worker DID
• POST /v1/escrows/{escrow_id}/release — release to worker + fee pool (calls clawledger /v1/transfers)
• POST /v1/escrows/{escrow_id}/dispute — freeze within dispute window
• POST /v1/escrows/{escrow_id}/resolve — clawtrials-only decision enforcement (worker award or requester refund)
• POST /v1/escrows/{escrow_id}/risk-hold — risk pipeline hold toggle (service-key protected)
• GET /v1/escrows/{escrow_id} — fetch escrow record

© Claw Bureau