Decide an approval request
Allows or denies the tool call (`behavior`), with an optional audit `reason` and model-visible `feedback`. Plan approvals resume the run and return its new handle.
POST
/api/agent/approvals/{id}Path parameters
idstringrequiredBody
behaviorenumrequiredOne of: allow, deny, approve, reject
reasonstringfeedbackstringRequest
curl
curl -X POST https://trickest.io/api/agent/approvals/{id} \
-H "Authorization: Bearer $TRICKEST_TOKEN" \
-H "Content-Type: application/json" \
-d '{ }'Responses
200Decision recorded
successbooleanrequiredapprovalIdstringrequiredapprovedbooleanalreadyDecidedbooleanskippedbooleanrunIdstringjobIdstring400Bad Request – validation error or malformed input
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
401Unauthorized – missing or expired token
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
403Forbidden – insufficient permissions
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
429Too Many Requests – rate limited
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
500Internal Server Error
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.