{"uid":"cap_FwkMFhaXer2RWpdBj6x5z","slug":"brainiac-agent-contract-expiry-check-997a1b0b","name":"BRAINIAC Agent Contract Expiry Check","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/agent-contracts/expiry-contract-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"openapi":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{}},"workflows":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":160,"minLength":1},"steps":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":160,"minLength":1},"operation":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":4000}},"additionalProperties":false},"maxItems":30},"states":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":40},"description":{"type":"string","maxLength":8000},"transitions":{"type":"array","items":{"type":"object","required":["from","to"],"properties":{"on":{"type":"string","maxLength":200},"to":{"type":"string","maxLength":80,"minLength":1},"from":{"type":"string","maxLength":80,"minLength":1},"operation":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":80}},"additionalProperties":false},"maxItems":12},"operations":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":160,"minLength":1},"path":{"type":"string","maxLength":400},"steps":{"type":"array","items":{"type":"string","maxLength":200,"minLength":1},"maxItems":20},"method":{"type":"string","maxLength":16},"summary":{"type":"string","maxLength":1000},"examples":{"type":"array","items":{},"maxItems":8},"responses":{"type":"array","items":{"type":"object","properties":{"schema":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{}},"status":{"type":"string","maxLength":40},"example":{},"examples":{"type":"array","items":{},"maxItems":8},"description":{"type":"string","maxLength":4000}},"additionalProperties":false},"maxItems":20},"parameters":{"type":"array","items":{"type":"object","required":["name"],"properties":{"in":{"enum":["query","header","path","cookie","body"],"type":"string"},"name":{"type":"string","maxLength":120,"minLength":1},"schema":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{}},"required":{"type":"boolean"},"description":{"type":"string","maxLength":4000}},"additionalProperties":false},"maxItems":40},"description":{"type":"string","maxLength":8000},"outputSchema":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{}},"requestSchema":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{}}},"additionalProperties":false},"maxItems":40}}},"responseSchema":{"type":"json","example":{"score":55,"issues":[{"type":"missing_expiry","evidence":"upload_url","location":"operations[0].outputSchema.properties.upload_url","severity":"high","description":"A temporary URL or token is named, and neither the field nor the operation states when it stops being valid. The lifetime is undocumented, not observed.","agent_impact":"An agent may call the URL after it has stopped working, or it may refresh a value that the contract never says to refresh.","suggested_fix":"State the lifetime, such as expires in 15 minutes, or name an expires_at field."},{"type":"contradictory_expiry","evidence":"The access token never expires. It expires in 5 minutes.","location":"operations[1]","severity":"high","description":"The same description both gives a lifetime and says the value does not expire. These are conflicting sentences in the contract.","agent_impact":"An agent cannot decide whether to refresh the URL or token before using it.","suggested_fix":"Keep one statement: a lifetime, or an explicit statement that it does not expire."}],"success":true,"analysis":"Checked 2 operations that name a temporary URL or token.","warnings":[],"limitations":["Checks read only the supplied operations, workflows, and OpenAPI document. No URL is fetched and no model reads the text.","A missing sentence is an undocumented contract. It is not a confirmed defect in a running implementation.","A contradiction is two statements in the supplied text. It is not proof of how a server behaves.","The HTTP method is not evidence that an operation is safe to retry or that it is idempotent.","Matches are fixed phrases and field names. They do not infer a business rule that the text does not state.","Temporary names are presigned or signed URLs, upload and download URLs, access, refresh, and session tokens, and one-time codes. A bare url or token is not enough.","A sibling expires, expiry, or ttl field counts as documented lifetime. Each missing lifetime subtracts 20. A contradiction subtracts 25.","The score is omitted when the document names no temporary resource."],"recommendations":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Oo3-mIDViAW7wdtYMSRtX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes an OpenAPI contract, operations, and workflows to detect missing or contradictory expiry documentation for temporary URLs, tokens, and credentials","exampleAgentPrompt":"Can you check my OpenAPI contract and these operations for any missing or contradictory expiry documentation on temporary URLs and access tokens — I need a compliance score and a list of any issues found?","exampleUseCases":[{"title":"Audit presigned upload URL contract","prompt":"I have an OpenAPI spec for my file upload service that uses presigned S3 URLs — can you check whether the contract properly documents when those URLs expire and flag any issues that might confuse an AI agent using the API?"},{"title":"Detect contradictory token lifetime statements","prompt":"My API docs say in one place that the access token never expires, and somewhere else that it expires in 5 minutes — can you run an expiry contract check on these operations and tell me exactly where the contradiction is and how to fix it?"},{"title":"Validate agent workflow credential expiry","prompt":"Before I deploy this multi-step workflow for my AI agent, can you check whether every temporary credential and session token in the workflow has its lifetime properly documented, and give me a score so I know if it's safe to ship?"}],"resultDescription":"Returns a JSON object containing a numeric compliance score (0-100), a boolean success flag, an analysis summary string, an array of issues each with type, severity (high/medium/low), location path, evidence text, description, agent_impact, and suggested_fix, plus warnings and limitations arrays explaining what the checker can and cannot determine.","failureModes":["Malformed or missing OpenAPI/operations input returns a validation error","Truncated or very large schemas may exceed processing limits","The checker only reads supplied text — it does not fetch live URLs or validate running implementations","Fixed-phrase matching may miss custom or unusual naming conventions for temporary tokens","No network errors expected since no external URLs are fetched"],"whenToPreferThis":"Use this endpoint when you need a lightweight, deterministic, pay-per-call audit of an API contract's expiry documentation quality — specifically to catch missing lifetimes or contradictory expiry statements before deploying an AI agent that will call the API. Prefer this over manual review when you need a machine-readable score and structured issue list. It is not a substitute for runtime testing or dynamic security scanning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:36:59.504Z","isFirstParty":false,"canonicalSlug":"brainiac-agent-contract-expiry-check-997a1b0b"}