Block Operations
resource: block — 4 operations on the raw block layer beneath DAG
get
Binary output.
| Field | Type | Required |
|---|---|---|
cid | text | ✓ Yes |
Missing cid → CFG_MISSING_CID. Response: { cid, data, size, mimeType } —
data is the raw single-block byte[]; mimeType is a fixed
application/octet-stream (not reported by Kubo).
put
Binary input.
| Field | Type | Required | Default |
|---|---|---|---|
inputDataKey | text | No | data |
dataMode | select | No | base64 (or text) |
inlineContent | text | No | — |
cidCodec | text | No | raw (IPLD multicodec label; also dag-pb, dag-cbor) |
mhtype | text | No | sha2-256 |
mhlen | int | No | — optional multihash length override |
pin | bool | No | false |
Content resolved from InputData[inputDataKey], else inlineContent; empty →
MISSING_CONTENT, bad base64 → INVALID_CONTENT_ENCODING. Response: { cid,
size }.
remove
| Field | Type | Required | Default |
|---|---|---|---|
cid | text | ✓ Yes | — |
force | bool | No | false — ignore nonexistent blocks and continue |
quiet | bool | No | false — minimal Kubo-side output; doesn't change this node's output contract |
Missing cid → CFG_MISSING_CID. Response: { cid, ok }.
200-with-embedded-error: Kubo can report a per-block removal failure inside an HTTP 200
response body (a non-empty
Error field) rather than a non-2xx status. This node surfaces
that as ok: false rather than an HTTP-level error.
stat
| Field | Type | Required |
|---|---|---|
cid | text | ✓ Yes |
Missing cid → CFG_MISSING_CID. Response: { cid, size } — metadata only, no
content transfer.