{"id":"quota-reservation-check","title":"Would this request fit in the remaining quota, given a snapshot and pending reservations? (snapshot-bound)","description":"Computes available quota from a caller-supplied snapshot (limit, used, reserved) minus the unexpired pending reservations and says whether a requested amount fits. This is a read of the numbers you supply as of snapshotAt: it reserves nothing, so concurrent consumers can still use the quota before you do, and every response says so. A stale snapshot gives unknown, not pass; a window that ended at or before asOf gives unknown even when the request does not fit, because the numbers belong to the previous window. Does not query any provider and is not a rate limiter (use the coordination token-bucket for reservations).","roi":"Avoids starting a job that cannot finish for lack of quota, without claiming a guarantee it cannot give.","audience":"agent-infra","package":"execution-safety-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/quota-reservation-check","path":"/api/v1/quota-reservation-check","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["quota","request","snapshotAt","asOf"],"properties":{"quota":{"type":"object","additionalProperties":false,"required":["limit","used"],"properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"reserved":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Amount already reserved and counted outside `pending`."},"windowEndsAt":{"type":"string","maxLength":40,"description":"RFC 3339 end of the quota window the snapshot belongs to."}}},"pending":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["id","amount"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"string","maxLength":40,"description":"RFC 3339; a reservation expiring at or before asOf no longer holds quota. Omit for a hold that does not expire."}}}},"request":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"snapshotAt":{"type":"string","maxLength":40,"description":"RFC 3339 instant the quota numbers were read."},"asOf":{"type":"string","maxLength":40,"description":"RFC 3339 instant of the decision (no clock is read)."},"maxSnapshotAgeSeconds":{"type":"integer","minimum":0,"maximum":31536000}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"available":{"type":"integer","description":"limit - used - reserved - held pending; may be negative if oversubscribed."},"held":{"type":"integer","description":"Sum of unexpired pending reservations."},"shortfall":{"type":"integer","description":"How much the request exceeds available; 0 when it fits."},"snapshotBound":{"type":"boolean","description":"Always true: nothing is reserved."},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"available":{"type":"integer","description":"limit - used - reserved - held pending; may be negative if oversubscribed."},"held":{"type":"integer","description":"Sum of unexpired pending reservations."},"shortfall":{"type":"integer","description":"How much the request exceeds available; 0 when it fits."},"snapshotBound":{"type":"boolean","description":"Always true: nothing is reserved."},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"quota":{"limit":1000,"used":700,"reserved":50},"pending":[{"id":"job-1","amount":100}],"request":{"amount":120},"snapshotAt":"2026-11-04T12:00:00Z","asOf":"2026-11-04T12:00:20Z","maxSnapshotAgeSeconds":60},"openapiOperation":{"operationId":"quota_reservation_check","summary":"Would this request fit in the remaining quota, given a snapshot and pending reservations? (snapshot-bound)","description":"Computes available quota from a caller-supplied snapshot (limit, used, reserved) minus the unexpired pending reservations and says whether a requested amount fits. This is a read of the numbers you supply as of snapshotAt: it reserves nothing, so concurrent consumers can still use the quota before you do, and every response says so. A stale snapshot gives unknown, not pass; a window that ended at or before asOf gives unknown even when the request does not fit, because the numbers belong to the previous window. Does not query any provider and is not a rate limiter (use the coordination token-bucket for reservations).\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"agent-infra","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/quota-reservation-check","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["quota","request","snapshotAt","asOf"],"properties":{"quota":{"type":"object","additionalProperties":false,"required":["limit","used"],"properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"reserved":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Amount already reserved and counted outside `pending`."},"windowEndsAt":{"type":"string","maxLength":40,"description":"RFC 3339 end of the quota window the snapshot belongs to."}}},"pending":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["id","amount"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"string","maxLength":40,"description":"RFC 3339; a reservation expiring at or before asOf no longer holds quota. Omit for a hold that does not expire."}}}},"request":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"snapshotAt":{"type":"string","maxLength":40,"description":"RFC 3339 instant the quota numbers were read."},"asOf":{"type":"string","maxLength":40,"description":"RFC 3339 instant of the decision (no clock is read)."},"maxSnapshotAgeSeconds":{"type":"integer","minimum":0,"maximum":31536000}}},"example":{"quota":{"limit":1000,"used":700,"reserved":50},"pending":[{"id":"job-1","amount":100}],"request":{"amount":120},"snapshotAt":"2026-11-04T12:00:00Z","asOf":"2026-11-04T12:00:20Z","maxSnapshotAgeSeconds":60}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"available":{"type":"integer","description":"limit - used - reserved - held pending; may be negative if oversubscribed."},"held":{"type":"integer","description":"Sum of unexpired pending reservations."},"shortfall":{"type":"integer","description":"How much the request exceeds available; 0 when it fits."},"snapshotBound":{"type":"boolean","description":"Always true: nothing is reserved."},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/quota-reservation-check/","docsJson":"https://agents.writerslogic.com/docs/quota-reservation-check.json","sample":"https://agents.writerslogic.com/api/v1/samples/quota-reservation-check","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}