All docs / Build
Approvals (a person in the loop)
Let a workflow, agent or script pause until you decide in the console; the decision returns as a workflow event or a signed callback.
Open in the consoleAn approval is a question with a few fixed answers (approve / deny by default) that waits for a person. It appears under Approvals in the console and in your notification channels; whoever decides (you, or a workspace member who can write) settles it once. Requests expire after seven days unless you set a shorter expiresInSeconds.
Ask for one
bash
curl -s https://randallflare.com/api/edge/v1/approvals -H 'authorization: Bearer rfp_…' -H 'content-type: application/json' -d '{
"title": "Refund order 1042 (€120)?",
"body": "Customer reports the parcel never arrived; carrier shows delivered.",
"choices": ["approve", "deny", "ask-carrier"],
"meta": { "orderId": 1042 },
"callbackUrl": "https://shop.example.com/hooks/approval",
"expiresInSeconds": 86400
}'
# → { "approval": { "id": "apr_…", "status": "PENDING", "url": "/flare/approvals?id=apr_…" }, "callbackSecret": "…" } (the secret is shown once)