FruxonDocs
AgentsApprovals

Lists approval requests for the given agent, newest first

Kept as an alias of the tenant-wide list narrowed to one agent, because released SDKs still call it. It runs the same query, so both URLs return the same rows. Each item represents one parked execution waiting on a human gate, including the prompt text shown to the approver and the tool call arguments under review. Pass `Responded`, `Cancelled` or `Expired` to see history. Pair items in this list with `POST .../pendingApprovals/{pendingApproval}:respond` to resume them.

GET
/v1/tenants/{tenant}/agents/{agent}/pendingApprovals

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

tenant*string

The tenant identifier

Query Parameters

status?string

Filter by lifecycle state. Defaults to HumanApprovalStatus.Pending.

Value in"UNSPECIFIED" | "PENDING" | "RESPONDED" | "CANCELLED" | "EXPIRED"
PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/pendingApprovals"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "agentRevision": 0,
      "flow": "string",
      "sessionId": "string",
      "taskQueueId": 0,
      "executionRecordId": "00000000-0000-0000-0000-000000000000",
      "gateType": "TOOL_FLOW_STEP",
      "stepIdentifier": "string",
      "toolCallId": "string",
      "toolKey": "string",
      "outboundMessage": "string",
      "proposedParameters": {},
      "authorizedApprovers": [
        "string"
      ],
      "deliveryRoute": {
        "id": "00000000-0000-0000-0000-000000000000",
        "connectorId": "00000000-0000-0000-0000-000000000000",
        "provider": "string",
        "integrationConfigId": null,
        "environmentSlug": "string",
        "parameters": null
      },
      "deliveryMessageId": "string",
      "correlationToken": "string",
      "status": "PENDING",
      "expiresAt": 0,
      "respondedAt": 0,
      "respondedBy": "string",
      "decision": "APPROVE",
      "responseText": "string",
      "createdAt": 0,
      "modifiedAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Lists the immutable audit timeline for a single approval request, newest-first.

Each entry records one lifecycle transition (requested / responded / cancelled / expired) with the actor, the channel they acted through (web, connector, topic callback, system), and — for the decision — the verdict and any free text. The requested entry also carries the tool parameters that were put up for approval. Returns an empty page when the approval id does not belong to the agent in the route.

Lists immutable human-approval audit events for an agent, newest-first.

This is the operator/compliance review surface for HITL decisions on a single agent. It returns request, response, cancellation, and expiry events across approval requests. Use `eventType` to narrow the ledger to one lifecycle transition.