Decide an approval request

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
idstringrequired
Body
behaviorenumrequired

One of: allow, deny, approve, reject

reasonstring
feedbackstring

Request

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
successbooleanrequired
approvalIdstringrequired
approvedboolean
alreadyDecidedboolean
skippedboolean
runIdstring
jobIdstring
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.