Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Get an approval request

Get an approval request

Fetches a pending or decided tool-approval request raised by an agent run the caller can access.

GET/api/agent/approvals/{id}
Path parameters
idstringrequired

Request

curl
curl -X GET https://trickest.io/api/agent/approvals/{id} \
  -H "Authorization: Bearer $TRICKEST_TOKEN"

Responses

200The approval
idstringrequired
sessionIdstringrequired
vaultIdstringrequired
toolstringrequired
actionstring
inputobjectrequired
messagestring
statusstringrequired
expiresAtstring
decidedAtstring
decidedBystring
createdAtstringrequired
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.

PreviousAPI ReferenceIntroductionAgent - ApprovalsNextDecide an approval request