{"uid":"cap_4L3O6Gp6SOZUAOGbFuFRi","slug":"artefaktum-artifact-download-d79a5726","name":"Artefaktum Artifact Download","description":"Get a short-lived presigned URL to download an artifact's bytes (the latest version, or version_id). Returns {url, method, expires_at, version_id}. 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/:artifact_id/download?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":["artifact_id"],"properties":{"artifact_id":{"type":"string"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"run_id":{"type":"string"},"version_id":{"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_4ieP4UMvRiZ73l1kfQ5mg","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":"Returns a short-lived presigned URL to download an artifact's bytes (latest version or a specific version) from Artefaktum's pay-per-call storage API.","exampleAgentPrompt":"Can you get me a download link for artifact abc123 from Artefaktum? I want the latest version.","exampleUseCases":[{"title":"Download pipeline output artifact","prompt":"Fetch me a download link for artifact f7e21d09 from Artefaktum — I want to grab the latest output file from my ML pipeline run."},{"title":"Retrieve specific artifact version","prompt":"I need to download version v_abc456 of artifact 9d3c1b78 from Artefaktum so I can compare it with the current build."},{"title":"Access artifact in automated workflow","prompt":"In my data pipeline, once processing is done, pull a temporary download URL for artifact 3af8e120 from Artefaktum so the next step can read the file bytes."}],"resultDescription":"A JSON object containing: a short-lived presigned URL (url) to download the artifact bytes via HTTP, the HTTP method to use (method), the expiry timestamp (expires_at), and the resolved version_id of the artifact served.","failureModes":["artifact_id not found — 404 error if the artifact does not exist or belongs to a different wallet","version_id not found — 404 if the requested specific version does not exist","expired artifact — artifact may have passed its 30-day retention window","insufficient USDC balance — payment of $0.005 USDC required per call; failure if wallet has insufficient funds","presigned URL expiry — the returned URL is short-lived and will reject requests after expires_at","run_id mismatch — if the specified run_id does not match any version, an error or empty result may be returned"],"whenToPreferThis":"Use this endpoint when you need to actually download or stream the binary content of a stored artifact from Artefaktum. It is the correct choice when you have an artifact_id and need the raw bytes or a URL to pass to a downstream system. Prefer this over metadata-only endpoints when the goal is file retrieval rather than inspection of artifact properties.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:53:33.170Z","isFirstParty":false,"canonicalSlug":"artefaktum-artifact-download-d79a5726"}