{"uid":"cap_6BvUB5ANDEMIBMScAxFFW","slug":"identity-records-schema-directionality-validator-1c9620d0","name":"Identity Records - Schema Directionality Validator","description":"Compare closed export-field guarantees. Removing fields, changing types or weakening required/non-null promises breaks the declared reader; extra fields depend on its explicit strictness for public nonpersonal agent credential declarations. No DID resolution, live revocation lookup, signature verification, person identification, key custody or identity certification. Offline typed nonpersonal metadata only. Result retention: 24 hours; minimal receipt metadata: 90 days.","url":"https://www.mahastrategies.com/api/v1/verify/identity-records/schema-directionality?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"after":{"type":"array","maxItems":32,"minItems":0},"before":{"type":"array","maxItems":32,"minItems":1},"dataClass":{"enum":["public","synthetic"],"type":"string"},"nonpersonalMetadata":{"type":"boolean","const":true},"consumerAllowsExtraFields":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.035109","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.035109/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035109","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035109","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GK8EQbpNNCO4AuPoZlMFC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.035109","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares export-field schema directionality (before vs. after) to detect breaking changes in field removal, type changes, or weakened required/non-null guarantees for offline, nonpersonal public agent credential metadata.","exampleAgentPrompt":"Can you check whether my public nonpersonal credential schema changes are safe — specifically compare the before field list [credentialId, issuer, issuedAt] against the after list [credentialId, issuedAt] to see if removing the 'issuer' field breaks any declared reader guarantees?","exampleUseCases":[{"title":"Detecting breaking field removal in agent schema","prompt":"I'm about to ship a new version of our agent credential export schema — the old version had fields [agentId, role, scope, createdAt] and the new version drops 'scope'. Can you check if removing that field breaks our public nonpersonal schema guarantees, assuming consumers do not allow extra fields?"},{"title":"Validating type-change safety in synthetic metadata","prompt":"We changed the 'credentialExpiry' field from a string to an integer in our synthetic nonpersonal metadata schema. Compare the before fields [credentialId, credentialExpiry, issuer] to the after fields [credentialId, credentialExpiry, issuer] and tell me if that type change weakens any required or non-null promises for our declared readers."},{"title":"Auditing non-null promise weakening in public credentials","prompt":"Before I merge this PR, check our public nonpersonal credential schema directionality — before we had [agentHandle, namespace, version, status] all required, and after we're making 'status' optional. Does weakening that required promise break declared reader contracts, assuming consumers allow extra fields?"}],"resultDescription":"Returns a structured comparison of before and after schema field sets, flagging breaking changes such as removed fields, type alterations, or weakened required/non-null guarantees. Indicates whether the schema evolution is safe for declared readers given their strictness on extra fields. Does not perform DID resolution, live revocation, signature verification, person identification, or key custody. Results are retained for 24 hours; minimal receipt metadata is retained for 90 days.","failureModes":["before array is empty or missing (minItems:1 violated) — validation error returned","after array exceeds 32 items (maxItems exceeded) — request rejected","dataClass not in allowed enum ['public','synthetic'] — schema validation error","nonpersonalMetadata not set to true (const:true violated) — request rejected","malformed field entries in before/after arrays — parsing error","service unavailable causing no comparison result returned"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, offline, typed comparison of export schema field sets to detect breaking changes in nonpersonal agent credential metadata contracts — specifically for public or synthetic data classes. Prefer this over general schema diff tools when you need strict directionality semantics (field removal, type weakening, required/non-null promise degradation) evaluated against declared reader guarantees. Do not use this for live identity resolution, DID lookup, signature verification, or personal data schemas.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T00:52:14.138Z","isFirstParty":false,"canonicalSlug":"identity-records-schema-directionality-validator-1c9620d0"}