{"uid":"cap_alntvUOY865l67PDGVSv6","slug":"maha-revision-lineage-check-ba854fb2","name":"Maha Revision Lineage Check","description":"Check a revision handoff before reusing evidence. Compare one initial or superseding transition with its declared predecessor; return lineage inconsistencies and an integrity receipt. Does not establish authenticity, semantic equivalence or inherited review approval.","url":"https://www.mahastrategies.com/api/v1/micro/revision-lineage-check","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["dataClass","previous","next"],"properties":{"next":{"type":"object"},"previous":{"oneOf":[{"type":"object","required":["objectId","revisionDigest","predecessorDigest","relation"],"properties":{"objectId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$","maxLength":80},"relation":{"enum":["initial","supersedes"],"type":"string"},"revisionDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","maxLength":71},"predecessorDigest":{"oneOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","maxLength":71},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"dataClass":{"enum":["public","synthetic"],"type":"string"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["version","offerId","amountBaseUnits","inputDigest","result","boundaries","receiptDigest"],"properties":{"result":{"type":"object"},"offerId":{"enum":["revision-lineage-check"],"type":"string"},"version":{"enum":["maha-microproducts/0.1"],"type":"string"},"boundaries":{"type":"array","maxItems":128,"minItems":0},"inputDigest":{"type":"string","maxLength":71},"receiptDigest":{"type":"string","maxLength":71},"amountBaseUnits":{"enum":["6000"],"type":"string"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KFbWVUChpnIFteJQUg3ex","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a document revision's lineage by checking one initial or superseding transition against a declared predecessor, returning inconsistencies and an integrity receipt.","exampleAgentPrompt":"Check the revision lineage for object 'doc-policy-2024' where the previous revision has digest sha256:a3f1...c9 and predecessorDigest null with relation 'initial', and the next revision object is the updated policy body — I need to know if there are any lineage inconsistencies and get back an integrity receipt. Mark the dataClass as 'public'.","exampleUseCases":[{"title":"Auditing initial document creation","prompt":"I need to validate that document 'contract-v1-main' was correctly registered as an initial revision with no predecessor — its revisionDigest is sha256:b7e2d4a1f93c08e5d6b2a4f1c3e9d7b0a2c5f8e3d6b9a1c4f7e0d3b6a9c2f5e8, predecessorDigest is null, relation is 'initial', and the dataClass is 'synthetic'. Can you run a lineage check and give me the integrity receipt?"},{"title":"Validating a superseding revision chain","prompt":"Check whether revision sha256:c4d8e2f1a9b3c7d5e0f4a8b2c6d0e3f7a1b5c9d3e7f1a5b9c3d7e1f5a9b3c7d1 correctly supersedes its predecessor sha256:a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 for object 'report-quarterly-q3', with relation 'supersedes' and dataClass 'public' — return any inconsistencies and the integrity receipt."},{"title":"Compliance lineage audit for regulated content","prompt":"I need to audit the lineage transition for object 'legal-filing-2025-03' — the previous revision has digest sha256:f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2, a predecessor digest of sha256:e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8, relation 'supersedes', and dataClass 'public'. Flag any lineage inconsistencies for our compliance review."}],"resultDescription":"Returns a structured object containing lineage inconsistencies found in the revision transition, an integrity receipt (receiptDigest), an inputDigest, a boundaries array (up to 128 items), the offerId ('revision-lineage-check'), version string, and amount charged in base units (5004). Does not confirm authenticity, semantic equivalence, or inherited review approvals.","failureModes":["Invalid objectId format (must match pattern ^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$) returns validation error","revisionDigest or predecessorDigest not in sha256:<64 hex chars> format returns schema rejection","relation not 'initial' or 'supersedes' returns enum validation error","Missing required fields (dataClass, previous, next) returns 400-level error","dataClass not 'public' or 'synthetic' returns schema error","Supplying a non-null predecessorDigest when relation is 'initial' may trigger lineage inconsistency"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, deterministic check of a single revision transition in a document lineage chain — especially when you need an auditable integrity receipt (receiptDigest) proving the check was performed. Prefer it over full document authenticity or semantic equivalence checks, as it is scoped strictly to predecessor-chain consistency. Best for compliance workflows, provenance auditing, and version control systems where SHA-256 digest chaining is used.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:53.592Z","isFirstParty":false}