v1

latestOpenAPI 3.1.0Apache-2.02026-07-17586455.2 KB

Documents

Upload managed raw bytes for a registered document.

Stores the request body as the document's managed blob via the configured RawContentStore adapter (local_fs or s3), and promotes the document row to storage_mode='managed_blob' / raw_storage_status='blob_stored'. Idempotent on byte-identical input under the same document. Different bytes against an already-stored managed blob return 409 because the managed slot is immutable per row to avoid orphaning the prior blob. Returns 503 when the deployment runs rawStorageMode='pointer_only'.

put/v1/documents/{id}/raw

Path parameters

idstring uuid required

Query parameters

user_idstring required

content_typestring

Response

Upload result with storage URI + content hash + size.

content_hashstring required

delete_semantics'delete' | 'unpin' | 'tombstone' | 'null' nullable required

What AtomicMemory's DELETE call does at the provider boundary for this row's storage_provider. 'delete' = adapter issues the provider's removal operation; 'unpin' = removes AtomicMemory's pin but the provider's other peers may continue to serve; 'tombstone' = AtomicMemory stops managing the bytes but the decentralized network may still serve. null for pointer-only rows or providers not registered for cleanup.

document_idstring required

idempotent_skipboolean required

raw_storage_status'blob_stored' | 'blob_pending' | 'blob_available' required

size_bytesnumber required

storage_mode'managed_blob' required

storage_providerstring required

storage_uristring required