{"uid":"cap_UUpYpBOG0hOVsNFwkfTHF","slug":"tereno-evidence-artifact-5c72cb23","name":"Tereno Evidence Artifact","description":"Can this public Tereno artifact be reused? Return a typed provenance envelope with source capability, field paths, validity window and exact recomputation input. If the artifact has expired, its source is recomputed in place and the fresh answer ships inside the same response. Private transaction intent is rejected. Use when another agent gives you a Tereno artifactId.","url":"https://www.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":null,"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_R8Wx32vyK8hNHfcPNOGpU","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 or recomputes a provenance envelope for a public Tereno artifact, returning its source capability, field paths, validity window, and exact recomputation inputs.","exampleAgentPrompt":"Check whether this Tereno artifact sha256:3a7b1c2d4e5f6a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b can be reused and give me its provenance details, including the source capability and how long it's valid for.","exampleUseCases":[{"title":"Reuse check before paying again","prompt":"Another agent gave me a Tereno artifact ID sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b — can you check if it's still valid so I don't have to pay for a fresh call?"},{"title":"Audit artifact source and fields","prompt":"I have a Tereno artifact sha256:9f8e7d6c5b4a3928170605040302010f0e0d0c0b0a090807060504030201fffe — tell me which capability produced it, what field paths it covers, and what inputs would recompute it."},{"title":"Auto-refresh expired artifact","prompt":"Pull the provenance envelope for Tereno artifact sha256:aaabbbcccdddeee111222333444555666777888999000aaabbbcccdddeee1112223 and if it's expired go ahead and recompute it in place so I get the fresh answer."}],"resultDescription":"A typed provenance envelope containing: the source capability ID, covered field paths, validity window (validUntil), exact recomputation inputs, an optional 'refreshed' object if the artifact had expired and was recomputed on-the-fly, a verdict (allow/review/block), an invocation ID, and a receipt URL. If expired, the refreshed result's validUntil governs the payload.","failureModes":["Invalid or malformed artifactId (not matching sha256:[a-f0-9]{64} pattern) returns a validation error","Private or non-public artifact returns a rejection (private transaction intent blocked)","Artifact source capability is unavailable for recomputation, returning a service error","Expired artifact whose source recomputation also fails returns a stale/error response","Missing required artifactId query parameter returns a 400 error","Invalid quote id causes payment or authorization failure"],"whenToPreferThis":"Use this endpoint when another Tereno agent or capability has returned an artifactId and you need to determine if that result can be safely reused, understand its provenance, or automatically refresh it if expired — all in a single call. Prefer this over calling the original source capability directly when you already have an artifactId and want to avoid redundant computation and cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:14.754Z","isFirstParty":false}