Skip to main content
POST
/
agent
Confirmations (HITL)
curl --request POST \
  --url https://api.example.com/agent \
  --header 'Content-Type: application/json' \
  --data '
{
  "decision": "<string>"
}
'

​
Create confirmation request

Called by the plugin/gateway when a tool call requires human approval. 
{
  "action": "create-confirmation",
  "agent_id": "uuid",
  "tool_name": "gmail_send",
  "service_name": "gmail",
  "tool_args_summary": "to: team@celerflow.ai, subject: ...",
  "action_description": "Send email to team@celerflow.ai"
}

​
Response

{
  "id": "uuid",
  "status": "pending",
  "expires_at": "2026-03-28T07:05:00Z"
}

​
Respond to confirmation

{
  "action": "respond-confirmation",
  "confirmation_id": "uuid",
  "decision": "approved"
}
​
decision
string
required
One of: approved, denied.

​
Response

{
  "id": "uuid",
  "status": "approved",
  "decided_at": "2026-03-28T07:01:30Z"
}

​
Poll confirmation status

The plugin polls this to check whether the human has responded: 
{
  "action": "get-confirmation",
  "confirmation_id": "uuid"
}
Confirmations expire after 5 minutes. Expired requests are treated as denied.