{"uid":"cap_slcWriwb_UkTj9MOh_2JF","slug":"artefaktum-artifact-lookup-by-external-key-dd7d7328","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/:external_key?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_qKBq2hVoamCDrHmM5Tlst","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":"Retrieve a stored artifact by the user-defined external key name within a wallet's project, with optional freshness enforcement via max_age_seconds.","exampleAgentPrompt":"Can you fetch the artifact I stored under the key 'reports/q1-summary' in my Artefaktum project — only return it if it was stored within the last 3600 seconds.","exampleUseCases":[{"title":"CI pipeline artifact retrieval","prompt":"Grab the build artifact stored under the key 'builds/latest/linux-x64' from my Artefaktum project — only use it if it's less than 7200 seconds old."},{"title":"Agent memory recall by named key","prompt":"Look up the artifact I saved under the key 'agent-state/session-42' in my Artefaktum project and return whatever data is stored there."},{"title":"Cross-service config lookup","prompt":"Fetch the artifact stored under 'configs/prod/service-a' from my Artefaktum project — I want the latest version regardless of age."}],"resultDescription":"Returns the artifact object including its title, description, tags, metadata, status, expiry date, and latest version details. If the artifact is older than max_age_seconds, a 404 is returned instead.","failureModes":["404 returned if external_key does not exist in the specified project","404 returned if artifact exists but is older than max_age_seconds","Missing or invalid project_id causes a 400 or lookup failure","Payment failure or insufficient USDC balance prevents access","Expired artifacts (past 30-day storage window) return 404","Invalid or malformed external_key format causes lookup failure"],"whenToPreferThis":"Use this endpoint when you have your own human-readable or path-like name for an artifact and want to retrieve it without knowing its internal artifact ID. Ideal for workflows where artifacts are stored under semantic keys (like 'reports/q1' or 'configs/prod') and need to be fetched by name. The max_age_seconds parameter makes this especially useful for cache-like patterns where stale artifacts should be rejected. Prefer this over the ID-based artifact lookup when the external key is the natural identifier in your workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:38:15.426Z","isFirstParty":false,"canonicalSlug":"artefaktum-artifact-lookup-by-external-key-dd7d7328"}