{"uid":"cap_s1DapmSRjV-vv-24Pky0W","slug":"artefaktum-upload-new-artifact-version-b3f1a924","name":"Artefaktum Upload New Artifact Version","description":"Store a new version of an artifact the wallet owns, kept for 30 days: returns a presigned PUT URL for its bytes. Body: filename, content_type, size_bytes. 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/:artifact_id/uploads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"run_id":{"type":["string","null"]},"filename":{"type":"string"},"size_bytes":{"type":"integer"},"content_type":{"type":"string"},"infer_lineage":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EbHPnN1ifHqUQRCXM1Jg3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Initiates a new artifact version upload by returning a presigned PUT URL for the file bytes, with pricing based on file size","exampleAgentPrompt":"Upload a new version of my artifact abc123 to Artefaktum — the file is called results.csv, it's text/csv, and it's 4500000 bytes.","exampleUseCases":[{"title":"Versioned ML model checkpoint storage","prompt":"Save a new version of my model artifact def456 on Artefaktum — the file is model_checkpoint.bin, it's application/octet-stream, and it's 52000000 bytes."},{"title":"Pipeline output artifact archiving","prompt":"I just ran my data pipeline and need to store the output report on Artefaktum — artifact ID is xyz789, filename is pipeline_output.parquet, content type is application/parquet, and it's 8000000 bytes."},{"title":"Large dataset upload for a research project","prompt":"Upload a new version of dataset artifact qrs321 to Artefaktum — the file is named survey_data_2024.csv, it's text/csv, and the size is 95000000 bytes."}],"resultDescription":"Returns a presigned PUT URL that the caller uses to upload the file's raw bytes directly to object storage. After the PUT completes, the caller must POST to /v1/artifacts/{id}/versions/{version_id}/complete to finalize the version. Also returns a version_id for tracking.","failureModes":["size_bytes exceeds 1 GiB limit — request rejected","artifact_id does not belong to the paying wallet — unauthorized error","Invalid or missing content_type — validation error","Insufficient USDC balance to cover the size-tiered price — payment failure","Presigned URL expires before the PUT is completed — upload must be restarted","Missing required fields (filename, content_type, size_bytes) — 422 validation error"],"whenToPreferThis":"Use this endpoint when you need to store a new version of an existing artifact owned by your wallet on Artefaktum, especially when file sizes range from small (under 10 MiB at $0.01) to large (up to 1 GiB at $0.50). It is the correct entry point for any versioned file write operation on the platform. Prefer it over generic S3 or cloud storage when you need wallet-based ownership, automatic 30-day retention, versioning, and lineage tracking without a separate signup flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:48:47.397Z","isFirstParty":false,"canonicalSlug":"artefaktum-upload-new-artifact-version-b3f1a924"}