{"uid":"cap_M0ZQ09OYv0nJbOkeq66Om","slug":"artefaktum-get-artifact-by-id-c974b415","name":"Artefaktum Get Artifact by ID","description":"Store a file for 30 days: returns a presigned PUT URL for its bytes. Body: project_id (from GET /v1/projects), filename, content_type, size_bytes, title; optional tags, metadata, external_key. Price by size_bytes: $0.01 up to 10 MiB, $0.05 up to 100 MiB, $0.50 up to 1 GiB. After the PUT, POST /v1/artifacts/{id}/versions/{version_id}/complete (free, sign-in-with-x). 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/uploads?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}},"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_5S9uUDZ_424-fyhR6WhxZ","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 full metadata for a single artifact by its ID, including title, description, tags, metadata, status, expiry, and latest version info.","exampleAgentPrompt":"Fetch the details for artifact ID 'abc-123' from Artefaktum — I need its title, tags, status, and when it expires.","exampleUseCases":[{"title":"Check artifact status before processing","prompt":"Before I kick off my pipeline, can you pull up the details for artifact 'df7e-9201' in Artefaktum? I want to confirm it's still active and hasn't expired yet."},{"title":"Audit artifact metadata after upload","prompt":"I just uploaded a file and got artifact ID 'b3c1-4455' — can you fetch its full metadata from Artefaktum so I can confirm the title, tags, and description were saved correctly?"},{"title":"Retrieve latest version info for a file","prompt":"What's the latest version info and expiry date for artifact '7fa2-0098' in Artefaktum? I need to decide if I should renew it or let it expire."}],"resultDescription":"Returns a JSON object containing the artifact's title, description, tags, metadata key-value pairs, current status (e.g. active/expired), expiry timestamp, and details about the latest version (such as filename, content type, size, and sha256). Costs $0.005 USDC per call, charged via x402 payment protocol.","failureModes":["Invalid or non-existent artifact_id returns a 404 not found error","Insufficient USDC balance or failed x402 payment causes a 402 payment required response","Artifact belongs to a different wallet and is not accessible, returning 403 forbidden","Malformed artifact_id format may return a 400 bad request","Artifact has been deleted or fully expired and metadata may no longer be available"],"whenToPreferThis":"Use this endpoint when you know the artifact's UUID and need its full metadata snapshot — title, description, tags, status, expiry, and latest version — in a single call. Prefer this over the external_key lookup endpoint when you have the internal artifact ID. Use this instead of listing all artifacts when you only need one specific artifact's details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:30:19.808Z","isFirstParty":false,"canonicalSlug":"artefaktum-get-artifact-by-id-d16ee021"}