{"id":"document-supersession","title":"Is this document still current, or superseded by a newer one?","description":"Given the target document id, the supplied set of documents (id, effective date, which ids each one supersedes, withdrawn flag) and a reference date, reports whether the target is superseded or withdrawn as of that date, following supersession chains, and names the superseding document and its date. For an agent about to rely on a standard, price list, policy or datasheet revision. It can only see the documents supplied: 'current' requires the caller to declare the list complete, otherwise the answer is unknown. Does not fetch documents or compare their text.","roi":"Stops an agent citing a withdrawn or superseded revision.","audience":"business","package":"compliance-evidence-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/document-supersession","path":"/api/v1/document-supersession","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["target","documents","asOf"],"properties":{"target":{"type":"string","maxLength":200,"description":"Id of the document being relied on."},"documents":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string","maxLength":200,"description":"Document id."},"effectiveDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2}))?$","maxLength":40},"supersedes":{"type":"array","items":{"type":"string","maxLength":200,"description":"Id this document replaces."},"maxItems":50},"withdrawn":{"type":"boolean","description":"Withdrawn without replacement."}}},"maxItems":200,"minItems":1,"description":"The documents the caller knows of, including the target."},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2}))?$","maxLength":40,"description":"Reference date: a superseding document counts only if effective on or before it."},"listComplete":{"type":"boolean","description":"The caller asserts documents holds every document that could supersede the target. Required for a pass."}}},"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."},"requirements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string","enum":["met","unmet","unknown"]},"optional":{"type":"boolean"},"needs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"state":{"type":"string","enum":["yes","no","unknown"]},"reason":{"type":"string","enum":["satisfied","missing","stale","no-reference-instant","no-evidence-date","value-mismatch","type-mismatch","conflicting-evidence","negative"]},"evidence":{"description":"The evidence value the verdict rests on."}}}}}}},"counts":{"type":"object","properties":{"met":{"type":"integer"},"unmet":{"type":"integer"},"unknown":{"type":"integer"},"optional":{"type":"integer"}},"description":"Non-optional requirements by state; optional ones are counted separately."},"current":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true when pass, false when superseded or withdrawn, null when undecidable."},"supersededBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"effectiveDate":{"type":"string"},"via":{"type":"array","items":{"type":"string"}}}},"description":"Documents effective by asOf that replace the target, directly or through a chain."},"scheduled":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"effectiveDate":{"type":"string"}}},"description":"Superseding documents that take effect after asOf."},"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."},"requirements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string","enum":["met","unmet","unknown"]},"optional":{"type":"boolean"},"needs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"state":{"type":"string","enum":["yes","no","unknown"]},"reason":{"type":"string","enum":["satisfied","missing","stale","no-reference-instant","no-evidence-date","value-mismatch","type-mismatch","conflicting-evidence","negative"]},"evidence":{"description":"The evidence value the verdict rests on."}}}}}}},"counts":{"type":"object","properties":{"met":{"type":"integer"},"unmet":{"type":"integer"},"unknown":{"type":"integer"},"optional":{"type":"integer"}},"description":"Non-optional requirements by state; optional ones are counted separately."},"current":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true when pass, false when superseded or withdrawn, null when undecidable."},"supersededBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"effectiveDate":{"type":"string"},"via":{"type":"array","items":{"type":"string"}}}},"description":"Documents effective by asOf that replace the target, directly or through a chain."},"scheduled":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"effectiveDate":{"type":"string"}}},"description":"Superseding documents that take effect after asOf."},"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":{"target":"SPEC-2023-04","documents":[{"id":"SPEC-2023-04","effectiveDate":"2023-04-01"},{"id":"SPEC-2025-01","effectiveDate":"2025-01-15","supersedes":["SPEC-2023-04"]},{"id":"SPEC-2026-09","effectiveDate":"2026-09-01","supersedes":["SPEC-2025-01"]}],"asOf":"2026-11-04","listComplete":true},"openapiOperation":{"operationId":"document_supersession","summary":"Is this document still current, or superseded by a newer one?","description":"Given the target document id, the supplied set of documents (id, effective date, which ids each one supersedes, withdrawn flag) and a reference date, reports whether the target is superseded or withdrawn as of that date, following supersession chains, and names the superseding document and its date. For an agent about to rely on a standard, price list, policy or datasheet revision. It can only see the documents supplied: 'current' requires the caller to declare the list complete, otherwise the answer is unknown. Does not fetch documents or compare their text.\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":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/document-supersession","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["target","documents","asOf"],"properties":{"target":{"type":"string","maxLength":200,"description":"Id of the document being relied on."},"documents":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string","maxLength":200,"description":"Document id."},"effectiveDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2}))?$","maxLength":40},"supersedes":{"type":"array","items":{"type":"string","maxLength":200,"description":"Id this document replaces."},"maxItems":50},"withdrawn":{"type":"boolean","description":"Withdrawn without replacement."}}},"maxItems":200,"minItems":1,"description":"The documents the caller knows of, including the target."},"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2}))?$","maxLength":40,"description":"Reference date: a superseding document counts only if effective on or before it."},"listComplete":{"type":"boolean","description":"The caller asserts documents holds every document that could supersede the target. Required for a pass."}}},"example":{"target":"SPEC-2023-04","documents":[{"id":"SPEC-2023-04","effectiveDate":"2023-04-01"},{"id":"SPEC-2025-01","effectiveDate":"2025-01-15","supersedes":["SPEC-2023-04"]},{"id":"SPEC-2026-09","effectiveDate":"2026-09-01","supersedes":["SPEC-2025-01"]}],"asOf":"2026-11-04","listComplete":true}}}},"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."},"requirements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string","enum":["met","unmet","unknown"]},"optional":{"type":"boolean"},"needs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"state":{"type":"string","enum":["yes","no","unknown"]},"reason":{"type":"string","enum":["satisfied","missing","stale","no-reference-instant","no-evidence-date","value-mismatch","type-mismatch","conflicting-evidence","negative"]},"evidence":{"description":"The evidence value the verdict rests on."}}}}}}},"counts":{"type":"object","properties":{"met":{"type":"integer"},"unmet":{"type":"integer"},"unknown":{"type":"integer"},"optional":{"type":"integer"}},"description":"Non-optional requirements by state; optional ones are counted separately."},"current":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true when pass, false when superseded or withdrawn, null when undecidable."},"supersededBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"effectiveDate":{"type":"string"},"via":{"type":"array","items":{"type":"string"}}}},"description":"Documents effective by asOf that replace the target, directly or through a chain."},"scheduled":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"effectiveDate":{"type":"string"}}},"description":"Superseding documents that take effect after asOf."},"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/document-supersession/","docsJson":"https://agents.writerslogic.com/docs/document-supersession.json","sample":"https://agents.writerslogic.com/api/v1/samples/document-supersession","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"}}