GET /tool-approvals/{id}

Updated Oct 1, 20261 minute read

Get an approval

One request or run, watched as it settles. result carries what the endpoint answered once the call lands.

Part of Tool approvals.

Parameters

Name	In	Type	Required	Description
`id`	path	`string`	Yes	An approval id.

Status	Description
`200`	The approval.
`401`	The bearer token is missing, revoked, or expired.
`404`	Not one of yours, or not there at all.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`id`	`string`	No
`conversationId`	`string`	No
`toolName`	`string`	No
`toolDescription`	`string`	No
`input`	`string`	No	The call's arguments, as serialized JSON.
`status`	`"pending" \| "executing" \| "succeeded" \| "failed" \| "denied" \| "expired"`	No
`initiatedBy`	`"agent" \| "teammate"`	No
`requestedAt`	`integer`	No
`expiresAt`	`integer`	No
`resolvedByName`	`any`	No
`resolvedAt`	`any`	No
`result`	`any`	No	What the endpoint answered, on a call that got that far.
`error`	`any`	No

curl https://api.median.sh/v1/tool-approvals/id \
  -H "Authorization: Bearer $BEARER_AUTH"