GET /tool-approvals

Updated Oct 1, 20261 minute read

List approvals

Everything pending in the organization, newest first. Name a conversation to get its whole recent history instead, settled rows included.

Part of Tool approvals.

Parameters

Name	In	Type	Required	Description
`conversation`	query	`string`	No	A conversation id, for its recent approvals.

Status	Description
`200`	The approvals.
`401`	The bearer token is missing, revoked, or expired.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

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

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