Xenodia Docs
API ReferenceGenerated Reference

Confirm the exact total for one past request

Owner browser access token required. Confirms a verified actual amount for the original funding relationship and attempts settlement. Frozen credits count toward this total. This is not an additional charge of the same amount, does not change future Agent limits, and must not repeat model execution. A 200 response can still have pending_settlement status when funds or payment review prevent completion. Repeating the same authorization cannot charge twice. Confirmation preserves the original payer set, including for self_then_owner requests that were reserved entirely from the Agent. After unlinking, the original funding owner may approve its historical charge; only original Agent reservations and that original owner can fund it. Detached Agent balances or a new owner are never added as supplementary payers.

POST
/v1/credits/settlements/authorize

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://api.xenodia.xyz/v1/credits/settlements/authorize" \  -H "Content-Type: application/json" \  -d '{    "request_id": "string",    "actual_amount_micro": 1,    "confirm": true  }'
{
  "billing_state": "string",
  "request_id": "string",
  "actor_account_id": 0,
  "reserve_amount_micro": 0,
  "actual_amount_micro": 0,
  "status": "reserved",
  "authorized": true,
  "payment_review_required": true,
  "historical_owner": true,
  "can_authorize": true,
  "shortfall_micro": 0,
  "funding_accounts": [
    {
      "account_id": 0,
      "reserved_amount_micro": 0,
      "available_amount_micro": 0,
      "supplemental_allowed": true
    }
  ]
}
{
  "error": "bad_request",
  "message": "string",
  "type": "string",
  "code": "string"
}
Empty
Empty