{"uid":"cap_Vw74F3m4UXuL_E6dqHTUi","slug":"artefaktum-get-artifact-by-id-d16ee021","name":"Artefaktum Get Artifact by ID","description":"Search the artifacts in one of the wallet's projects by meaning and by text (mode hybrid, semantic, text or exact), with filters on content type, tags, status and dates. Body: project_id, query. Returns {items: [{artifact, score, match_mode}], next_cursor, mode}. Costs $0.01 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/search?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_PYsGCAbnPi3wVFjuCi10_","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 metadata for a single artifact by its ID, including title, description, tags, custom metadata, status, expiry, and latest version info.","exampleAgentPrompt":"Pull up the metadata for artifact ID 'art_abc123' on Artefaktum — I want to see its title, description, tags, current status, and when it expires.","exampleUseCases":[{"title":"Check artifact expiry before use","prompt":"Look up artifact 'art_7f9d2e' on Artefaktum and tell me its current status and when it's set to expire — I need to know if it's still valid."},{"title":"Audit artifact tags and description","prompt":"Fetch the metadata for Artefaktum artifact ID 'art_55abc1' so I can review its title, tags, and description before sharing it with my team."},{"title":"Inspect latest version of stored file","prompt":"Get me the details on artifact 'art_99xyz4' — specifically what the latest version is and what metadata is attached to it."}],"resultDescription":"Returns a JSON object containing the artifact's title, description, tags, custom metadata fields, current status (e.g. active/expired), expiry timestamp, and information about the latest version of the artifact's content.","failureModes":["Artifact ID not found — 404 response if the artifact_id does not exist or belongs to a different wallet","Payment failure — x402 payment of $0.005 USDC not processed correctly","Expired artifact — artifact exists but status indicates it has expired","Malformed artifact_id — invalid format causes 400 bad request","Wallet mismatch — artifact belongs to a project not accessible by the paying wallet"],"whenToPreferThis":"Use this endpoint when you have a specific artifact_id and need its full metadata snapshot (title, description, tags, status, expiry, latest version) without downloading the actual file bytes. Prefer this over listing endpoints when you already know the ID, and over the download URL endpoint when you only need metadata rather than file content. Use the external_key lookup sibling if you stored the artifact under your own custom name.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:52:28.064Z","isFirstParty":false,"canonicalSlug":"artefaktum-get-artifact-by-id-d16ee021"}