{"uid":"cap_pVBLDnfkdm7lW5gulpyA7","slug":"agent-delivery-fallback-gate-3fb39106","name":"Agent Delivery Fallback Gate","description":"Agent Delivery Fallback Gate: Agent Delivery Fallback Gate checks whether failure conditions permit a declared fallback from bounded caller-supplied values without an external provider. Call Agent Delivery Fallback Gate before paying for or accepting an x402 or agent delivery assembled from caller-supplied challenge and result metadata. Returns contract-specific checks, normalized evidence, mismatch reasons, and an explicit acceptance or rejection status for Agent Delivery Fallback Gate as vers…","url":"https://api.delx.ai/api/v1/x402/agent-delivery-fallback-gate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"failure_code":{"type":"string","maxLength":8192,"description":"Failure Code supplied to Agent Delivery Fallback Gate; used only for this bounded calculation and processed in memory without retention."},"primary_status":{"type":"string","maxLength":8192,"description":"Primary Status supplied to Agent Delivery Fallback Gate; used only for this bounded calculation and processed in memory without retention."},"fallback_available":{"type":"boolean","description":"Fallback Available supplied to Agent Delivery Fallback Gate; used only for this bounded calculation and processed in memory without retention."},"allowed_failure_codes":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":256,"description":"Allowed Failure Codes supplied to Agent Delivery Fallback Gate; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"failure_allowed":true,"fallback_permitted":true},"schema":"delx/util-agent-delivery-fallback-gate/v1","status":"pass","evidence":{"retained":false,"input_sha256":"90bc182d30b20aad9cdbf98c44d1452bf8205f8ad59c3d598c333e1fd05badaf","external_calls":0},"operation":"delivery_contract:agent_delivery_fallback_gate"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ggtL7qMwz-bxVwYCyURP1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates whether a declared fallback is permissible given failure conditions and caller-supplied challenge/result metadata before accepting or paying for an x402 agent delivery.","exampleAgentPrompt":"Before I accept and pay for this agent delivery fallback, check if the failure code 'TIMEOUT_503' with primary status 'partial' is allowed to fall back — the allowed codes are ['TIMEOUT_503', 'RATE_LIMIT_429'] and fallback_available is true.","exampleUseCases":[{"title":"Pre-payment fallback gate for timed-out task","prompt":"I got a fallback result from my agent delivery but the original task timed out with code 'TIMEOUT_503' and primary status 'failed' — check whether this fallback is actually permitted before I pay for it, given allowed codes are ['TIMEOUT_503', 'GATEWAY_504'] and fallback is marked available."},{"title":"Rejecting unauthorized fallback claim","prompt":"An agent is claiming a fallback delivery under failure code 'AUTH_401', but our contract only allows fallbacks for ['TIMEOUT_503', 'RATE_LIMIT_429'] — run this through the fallback gate with fallback_available true and primary status 'error' so I know if I should reject it."},{"title":"Automated x402 agent delivery acceptance pipeline","prompt":"Before my system auto-accepts this x402 agent delivery result, validate the fallback gate: failure code is 'RATE_LIMIT_429', primary status is 'degraded', fallback_available is true, and allowed failure codes are ['RATE_LIMIT_429', 'TIMEOUT_503']."}],"resultDescription":"Returns contract-specific validation checks, normalized evidence of the failure conditions, reasons for any mismatch between declared and allowed fallback codes, and an explicit acceptance or rejection status indicating whether the fallback claim should be honored.","failureModes":["Missing or malformed failure_code causes validation to fail with unclear rejection","fallback_available set incorrectly may lead to unexpected rejection despite valid codes","Caller-supplied allowed_failure_codes list not matching contract expectations causes false rejections","Empty allowed_failure_codes array results in blanket rejection of all fallbacks","Primary status not aligning with failure_code produces mismatch reasons even for valid scenarios"],"whenToPreferThis":"Use this endpoint when you need to gate acceptance or payment of an x402 agent delivery that includes a fallback claim, especially when you want to verify that the failure conditions genuinely permit a fallback before committing funds. Prefer this over manual logic when dealing with complex allowed-code lists or when audit-quality normalized evidence and explicit accept/reject outputs are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T17:52:47.936Z","isFirstParty":false}