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.
Authorization
bearerAuth 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"
}