One API call lets any AI agent pause, send context to a human approver, and resume only after a decision — in seconds.
Your AI agent calls POST /api/pause with the action it wants to take and any context. Gets back a watchId.
Approvers get an email instantly. They see the action, the context, and one-click Approve / Reject buttons.
The agent polls GET /api/pause/:watchId or receives a webhook. It sees approved or rejected and acts accordingly.
Works with any language, any framework, any agent runtime. If it can make HTTP requests, it can use Ambedo HITL.
/api/pauseCreate a pause request
/api/pause/:watchIdPoll for approval status
/api/pauseList pauses — ?status=pending&limit=50&offset=0
/api/pause/:watchId/approveHuman approves or rejects (requires dashboard session)
const res = await fetch("https://hitl.ambedolabs.com/api/pause", {
method: "POST",
headers: {
"Authorization": "Bearer hitl_your_api_key",
"Content-Type": "application/json"
},
body: JSON.stringify({
action: "Deploy to production (v2.4.1)",
context: { environment: "prod", commit: "a3f9b2e" }
})
});
const { watchId, statusUrl } = await res.json();
// Poll for approval
while (true) {
const status = await fetch(statusUrl, {
headers: { "Authorization": "Bearer hitl_your_api_key" }
}).then(r => r.json());
if (status.status !== "pending") {
if (status.status === "approved") continueWithDeploy();
else abortDeploy();
break;
}
await sleep(3000);
}