FruxonDocs
AgentsApprovals

Cancels a pending request without resuming the execution

Use this when an operator wants to abandon a parked execution rather than approve or reject — for example, when the request has gone stale or was triggered by a bad input. The execution is finalized as Failed with the supplied reason recorded on the trace, so downstream metrics and alerts treat it as a non-completion rather than a rejection. Returns 409 if the request has already been responded to or cancelled; in that case the existing terminal state is authoritative.

POST
/v1/tenants/{tenant}/agents/{agent}/pendingApprovals/{pendingApproval}:cancel

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.

Formatuuid
tenant*string

The tenant identifier

Request Body

Optional cancellation reason.

reason?string|null

Optional free-text reason recorded alongside the cancellation.

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/agents/string/pendingApprovals/497f6eca-6276-4993-bfeb-53cbbbba6f08:cancel" \  -H "Content-Type: application/json" \  -d '{}'
{
  "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": "00000000-0000-0000-0000-000000000000",
    "environmentSlug": "string",
    "parameters": {}
  },
  "deliveryMessageId": "string",
  "correlationToken": "string",
  "status": "PENDING",
  "expiresAt": 0,
  "respondedAt": 0,
  "respondedBy": "string",
  "decision": "APPROVE",
  "responseText": "string",
  "createdAt": 0,
  "modifiedAt": 0
}
Empty
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 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.

Gets a single approval request by id.

Returns the full record for one human-approval gate, including its current lifecycle state, the tool call payload awaiting approval, the parent execution id, and (if already resolved) the responder identity, decision, and decision text. Returns 404 if the approval id does not belong to the agent in the route — approval ids are agent-scoped and cross-agent access is not permitted even with tenant-admin credentials.