{"uid":"cap_2-Ju3XL28zXzegtR_jSTZ","slug":"kiln-stash-finalize-object-82c6b6f9","name":"Kiln Stash - Finalize Object","description":"TTL artifact storage for AI agents backed by S3-compatible object storage.","url":"https://stash.fluidrack.com/v1/objects/%7Bid%7D/finalize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string"},"sha256":{"type":"string"}}},"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_TaBZpGiGb1S_RFVS7iNNV","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":"Finalizes a previously reserved TTL object slot in S3-compatible storage by confirming its SHA-256 hash, committing the artifact for agent retrieval.","exampleAgentPrompt":"I just uploaded the artifact to the reserved slot — go ahead and finalize object ID 'a1b2c3d4' with SHA-256 hash 'e3b0c44298fc1c149afb4c8996fb92427ae41e4649b934ca495991b7852b855' to commit it to Kiln Stash.","exampleUseCases":[{"title":"Commit AI-generated report artifact","prompt":"I've finished uploading the generated report to the reserved stash slot — finalize object 'rpt-20240601-xyz' with SHA-256 'abc123def456...' so the downstream agent can retrieve it."},{"title":"Seal pipeline intermediate result","prompt":"The data processing step is done and the intermediate file is uploaded — please finalize object ID 'pipe-stage2-001' with its SHA-256 checksum 'f2ca1bb6c7e907d06dafe4687e579fce76b37e4e93b7605022da52e6ccc26fd2' to lock it into Kiln Stash."},{"title":"Complete two-phase model checkpoint upload","prompt":"My model checkpoint upload is complete — finalize the stash object 'ckpt-llm-run42' using SHA-256 'ba7816bf8f01cfea414140de5dae2ec73b00361bbef0469348d8ceac60b4a453' so other agents in the fleet can access it."}],"resultDescription":"A confirmation response indicating the object has been successfully finalized and committed to TTL storage, including the object ID and its verified status. The artifact is now available for retrieval by agents until its TTL expires.","failureModes":["SHA-256 mismatch — provided hash does not match the uploaded content, causing rejection","Invalid or expired object ID — the reservation slot has expired or does not exist","Object already finalized — attempting to finalize an already-committed object","Storage backend error — S3-compatible backend unavailable or write failure","Missing required fields — either id or sha256 not provided in the request body"],"whenToPreferThis":"Use this endpoint as the second step of a two-phase upload workflow after reserving a TTL object slot via the companion reserve endpoint. It is the correct choice when you need to commit an uploaded artifact with integrity verification via SHA-256 before making it available for agent retrieval. Prefer this over single-step storage APIs when your workflow requires a reserve-then-finalize pattern, especially in multi-agent pipelines where upload confirmation and integrity checking are critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:46.938Z","isFirstParty":false}