FruxonDocs
AgentsApprovals

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.

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

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.

pendingApproval*string

The approval request ID whose timeline to read.

Formatuuid
tenant*string

The tenant identifier

Query Parameters

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/497f6eca-6276-4993-bfeb-53cbbbba6f08/auditEvents"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "approvalRequestId": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "sessionId": "string",
      "taskQueueId": 0,
      "toolKey": "string",
      "gateType": "TOOL_FLOW_STEP",
      "eventType": "REQUESTED",
      "channel": "WEB",
      "actor": "string",
      "decision": "APPROVE",
      "responseText": "string",
      "proposedParameters": {},
      "detail": "string",
      "correlationId": "string",
      "createdAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Forecast an agent's spend to the end of the month.

The UTC calendar month so far, day by day, and where it is likely to land in dollars and in credits, with a range. Read from the last four weeks with their day-of-week shape, across every revision. Without an environment the dollars are read against the agent-wide monthly budget, and the response says when a busy stretch could reach it.

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.