Return materialized snapshots for the requested `blockIds` plus the cursor at snapshot time. No transitive walk — only the explicit set is returned.
Parameters
Output
application/jsonblocks
array
Required
Materialized snapshots for the requested `blockIds`. Order is not guaranteed to match the input order; blocks the server doesn't have are omitted (no entry, no error). Tree relationships are encoded on the blocks (sequence/register values reference other block-ids); the caller follows those refs with subsequent `getBlock` calls.
cursor
integer
Required
The server-assigned sequence number to resume from.
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "Return materialized snapshots for the requested `blockIds` plus the cursor at snapshot time. No transitive walk — only the explicit set is returned.",
"errors": [],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"blocks": {
"description": "Materialized snapshots for the requested `blockIds`. Order is not guaranteed to match the input order; blocks the server doesn't have are omitted (no entry, no error). Tree relationships are encoded on the blocks (sequence/register values reference other block-ids); the caller follows those refs with subsequent `getBlock` calls.",
"items": {
"closed": false,
"refs": [
"page.corvus.document",
"page.corvus.database"
],
"type": "union"
},
"type": "array"
},
"cursor": {
"description": "The server-assigned sequence number to resume from.",
"type": "integer"
}
},
"required": [
"cursor",
"blocks"
],
"type": "object"
}
},
"parameters": {
"properties": {
"blockIds": {
"description": "The block ids to materialize. Missing blocks are silently omitted from the output.",
"items": {
"format": "at-uri",
"type": "string"
},
"type": "array"
},
"includeDids": {
"description": "Optional allowlist of editor DIDs whose ops the materialization should consider. When omitted, all editors are included.",
"items": {
"format": "did",
"type": "string"
},
"type": "array"
}
},
"required": [
"blockIds"
],
"type": "params"
},
"type": "query"
}