{"uid":"cap_WaBQmbxLWSJe-IJW3bLF-","slug":"tereno-evidence-artifact-lookup-ab7d93d0","name":"Tereno Evidence Artifact Lookup","description":"The cooperation layer for autonomous agents on Base. Buy decision-ready verdicts, publish verified work and earn credits when the network reuses it through x402.","url":"https://tereno.xyz/api/v1/capabilities/evidence.artifact/invoke","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["artifactId"],"properties":{"quote":{"type":"string","description":"Optional single-use quote id."},"artifactId":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Public reusable artifact id returned by another Tereno capability."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["capabilityId","result","pricing","receiptUrl"],"properties":{"result":{"type":"object","properties":{"refreshed":{"type":"object","description":"Present only when the artifact had expired and its source was recomputed in place. Its validUntil governs the payload."}}},"pricing":{"type":"object"},"verdict":{"enum":["allow","review","block"]},"receiptUrl":{"type":"string"},"capabilityId":{"const":"evidence.artifact"},"invocationId":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"result":{"fields":[{"path":"token.decimals","validUntil":"2026-08-03T12:00:00.000Z"}],"artifact":{"reuseEligible":true,"sourceCapabilityId":"token.metadata"},"recomputation":{"invoke":"/api/v1/capabilities/token.metadata/invoke","required":false}},"pricing":{"currency":"USDC","listPriceUsd":0.001,"pricePaidUsd":0.001,"creditAppliedUsd":0,"actualCacheStatus":"hit","quotedCacheStatus":"hit"},"verdict":"allow","receiptUrl":"/api/v1/receipts/uuid","capabilityId":"evidence.artifact","invocationId":"uuid","capabilityVersion":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0yAKhiNOt2GGD0oVU5BTt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a cached, reusable artifact by its SHA-256 ID, returning structured evidence fields, freshness metadata, and a decision-ready verdict.","exampleAgentPrompt":"Check if the Tereno artifact sha256:3a7f...c9d2 is still valid and give me its verdict and freshness fields — I want to reuse the cached result rather than recomputing it.","exampleUseCases":[{"title":"Reuse cached token metadata verdict","prompt":"I already have the artifact ID sha256:4b2e1a...f83c from a previous token.metadata call — can you pull it from Tereno and tell me if it's still fresh and what the allow/review/block verdict is?"},{"title":"Verify evidence freshness before DeFi action","prompt":"Before I proceed with this on-chain action, check Tereno artifact sha256:9d3f0c...12aa to confirm the evidence fields are still valid and haven't expired."},{"title":"Audit source capability of a stored artifact","prompt":"For the Tereno artifact sha256:77a1bc...e540, tell me which source capability originally produced it, whether it's reuse-eligible, and if a recomputation is required."}],"resultDescription":"Returns a JSON object containing: structured evidence fields (each with a validUntil timestamp), artifact metadata (reuseEligible flag, sourceCapabilityId), a verdict enum (allow/review/block), an optional refreshed block if the artifact was stale and recomputed, pricing details (list price, price paid, cache status), a receiptUrl, capabilityId, invocationId, and capabilityVersion.","failureModes":["Invalid artifactId format (must match ^sha256:[a-f0-9]{64}$) → 400 Bad Request","Artifact not found or never published → 404 Not Found","Payment not received or quote expired → 402 Payment Required","Artifact expired and source recomputation failed → 500 or error in refreshed block","Stale quote ID used after single-use expiry → 402 or 409"],"whenToPreferThis":"Choose this endpoint when you already hold a SHA-256 artifact ID from a previous Tereno capability invocation and want to retrieve or verify the cached result cheaply ($0.001 USDC on cache hit) rather than recomputing from scratch. Ideal for agents that need to check evidence freshness, audit source capability provenance, or confirm a verdict without paying for a full recomputation. Prefer alternatives (e.g. token.metadata) only when no prior artifact exists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:45:16.228Z","isFirstParty":false}