Audience: PMs, Devs
Outcomes: Workflows that cleanly map to milestones & acceptance.
Create order
curl -X POST $API_BASE/api/orders -b cookies.txt \ -H 'Content-Type: application/json' \ -d '{ "contractId":"ct_123","title":"LP redesign", "total":150000,"currency":"USD","reference":"PO-4421", "milestones":[ {"id":"m1","name":"Wireframes","amount":50000,"acceptance":"Figma links","dueAt":"2025-09-01T00:00:00Z"}, {"id":"m2","name":"Final design","amount":100000,"acceptance":"Assets + guide","dueAt":"2025-09-15T00:00:00Z"} ] }'
Get/list
GET /api/orders/{orderId} GET /api/orders?status=InProgress&limit=50
Upload deliverables (multipart)
curl -X POST $API_BASE/api/orders/ord_123/deliverables -b cookies.txt \ -F 'milestoneId=m1' -F 'notes=Initial wireframes' \ -F '[email protected]' -F '[email protected]'
Accept / Reject
POST /api/orders/{orderId}/deliverables/{deliverableId}/accept POST /api/orders/{orderId}/deliverables/{deliverableId}/reject # { "reason": "…" }