{"uid":"cap_eu-Gt8EF2tUSrBsVSrhX-","slug":"phion-mandate-capacity-reservation-a7db0495","name":"PHION Mandate Capacity Reservation","description":"Atomically reserve cumulative mandate capacity and return signed state","url":"https://phion.systems/v1/paid/mandates/reserve","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema"},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5dLs7FT06oy_KE-AuNIpW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Atomically reserves cumulative mandate capacity and returns a signed state receipt for AI-agent payment mandate workflows","exampleAgentPrompt":"Reserve cumulative mandate capacity for my agent's ongoing payment mandate and give me a signed state receipt confirming the reservation is locked in.","exampleUseCases":[{"title":"Pre-flight spend lock for agent pipeline","prompt":"Before my agent executes this multi-step purchase workflow, reserve the required mandate capacity and return a signed state so I can prove the budget is committed before disbursement starts."},{"title":"Incremental mandate headroom tracking","prompt":"My agent has a rolling payment mandate — reserve the next tranche of cumulative capacity and give me a signed state receipt so I can track how much has been allocated versus what remains."},{"title":"Atomic capacity hold before vendor payment","prompt":"I need to atomically lock mandate capacity for an upcoming vendor payment my AI agent is about to authorize — reserve it now and return the signed state so the transaction can proceed with proof of reservation."}],"resultDescription":"A signed state object confirming the atomic reservation of the requested mandate capacity, including cryptographic signature, reserved amount, cumulative mandate state, and a machine-readable receipt suitable for downstream verification or audit by AI agents.","failureModes":["Insufficient remaining mandate capacity — reservation rejected with capacity-exceeded error","Concurrency conflict — atomic reservation fails if another process modified mandate state simultaneously","Invalid or expired mandate identifier — returns authorization error","Malformed reservation parameters — returns validation error with field-level detail","Signature generation failure — internal error preventing signed state production"],"whenToPreferThis":"Use this endpoint when an AI agent needs to atomically reserve and lock spending capacity within a payment mandate before executing a transaction, especially when you need a cryptographically signed proof of reservation for audit, compliance, or downstream verification. Prefer this over generic payment initiation when the mandate's cumulative state must be tracked and the reservation must be atomic to prevent race conditions in multi-agent or multi-step commerce workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:13.725Z","isFirstParty":false}