Sign in

v1

latestOpenAPI 3.1.0Apache-2.02026-07-17586455.2 KB
Storage

Register a pointer artifact or upload a managed artifact.

Pointer mode sends a JSON body with mode: "pointer" plus a caller-supplied uri; the server stores the reference but NEVER fetches the URI. Managed mode sends the raw bytes with ?mode=managed[&disclose_content_hash=true] and an optional X-AtomicMemory-Metadata base64-JSON header. Filecoin direct managed uploads return 501 in v1.

post/v1/storage/artifacts

Request body

OR

Response

Artifact created.

artifact_idstring uuid required
content_encoding'identity' | 'aes_gcm' required
content_hashstring
content_typestring nullable required
created_atstring required
identifiersobject required

Provider-native identifiers (CID, etc.); allowlisted per provider.

metadataobject required

Caller-supplied metadata. Decoded JSON must be ≤4 KiB; encoded header value must be ≤8 KiB when sent via X-AtomicMemory-Metadata.

mode'pointer' | 'managed' required
providerstring required
provider_detailsobject

Allowlisted provider-specific public state.

size_bytesinteger nullable required
status'stored' | 'pending' | 'available' | 'unavailable' | 'deleting' | 'deleted' | 'delete_failed' | 'failed' required
updated_atstring required
uristring nullable required