{"uid":"cap_GXPNGbHLuSqaUK1WX9j3y","slug":"artefaktum-artifact-lookup-by-external-key-26f7cdef","name":"Artefaktum Artifact Lookup by External Key","description":"Look up an artifact by the external_key it was stored under (your own name for it, slashes allowed), in one of the wallet's projects. max_age_seconds turns an artifact older than that into a 404, for caching. Returns the artifact. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.","url":"https://api.artefaktum.dev/v1/artifacts/by-external-key/smoke/20261031223716?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["external_key"],"properties":{"external_key":{"type":"string"}},"additionalProperties":false},"queryParams":{"type":"object","required":["project_id"],"properties":{"project_id":{"type":"string"},"max_age_seconds":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kl_TK6N1JEczkoxvWrWFe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves an artifact stored under a user-defined external key (with slash-separated namespacing) from a wallet's project, with optional cache invalidation via max age.","exampleAgentPrompt":"Look up the artifact I stored under the key 'reports/q3-summary' in my Artefaktum project (project ID: proj_abc123) — only return it if it's been updated within the last 86400 seconds.","exampleUseCases":[{"title":"Retrieve pipeline output by job name","prompt":"Fetch the artifact I saved under 'pipeline/nightly-build/2024-10-31' in my Artefaktum project proj_xyz789 — reject it if it's older than 3600 seconds."},{"title":"Access shared config by slug","prompt":"Pull up the artifact stored under the key 'configs/prod/database' in Artefaktum project proj_config42 — I need whatever metadata and version info comes back with it."},{"title":"Check freshness of cached report","prompt":"Look up my Artefaktum artifact with external key 'analytics/weekly-report' in project proj_reports01, but treat it as missing if it's more than 604800 seconds old."}],"resultDescription":"Returns the artifact object including title, description, tags, metadata, status, expiry date, and latest version details. If the artifact is older than max_age_seconds (when specified), returns a 404 as if the artifact does not exist.","failureModes":["404 if no artifact exists under the given external_key in the specified project","404 if artifact exists but is older than max_age_seconds","402 Payment Required if the $0.005 USDC payment via x402 is not included or fails","400 if required path parameter external_key is missing","403 if the wallet does not own the specified project"],"whenToPreferThis":"Use this endpoint when you have stored an artifact under a human-readable or structured slash-path key of your own choosing and want to retrieve it without knowing the internal artifact ID. Prefer this over ID-based lookup when your workflow uses semantic or hierarchical naming for artifacts. The max_age_seconds parameter makes it especially useful for cache-validation workflows where stale data should be treated as absent.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:51:45.342Z","isFirstParty":false,"canonicalSlug":"artefaktum-artifact-lookup-by-external-key-dd7d7328"}