Read ops for the requested `blockIds` in forward cursor order, strictly after `cursor`.
Parameters
blockIds
array
of string
Required
The explicit set of block ids to read ops for. No transitive walk — only ops whose `blockId` is in this set are returned.
cursor
integer
Optional
Server-assigned cursor (exclusive) to resume from. Omitted = start from cursor 0 (every op the server has for the requested blocks). Same semantic as `page.corvus.subscribeOps#main.cursor`.
includeDids
array
of string
Optional
The dids of the users to include.
limit
integer
Optional
Maximum number of ops to return in this page.
Output
application/jsoncursor
integer
Optional
Cursor of the last op in `ops`. Pass this as `cursor` on the next call to continue paginating. Omitted when `ops` is empty (caller is caught up to the server's high-water for these blocks).
ops
array
Required
Ops for the requested blocks with cursor strictly greater than the input `cursor`, in ascending cursor order. Up to `limit` entries. Shape is identical to a live `page.corvus.subscribeOps#op` frame.
Errors
InvalidCursor
The supplied cursor is malformed or beyond the server's current high-water. Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"type": "query",
"errors": [
{
"name": "InvalidCursor",
"description": "The supplied cursor is malformed or beyond the server's current high-water."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"ops"
],
"properties": {
"ops": {
"type": "array",
"items": {
"ref": "page.corvus.subscribeOps#op",
"type": "ref"
},
"description": "Ops for the requested blocks with cursor strictly greater than the input `cursor`, in ascending cursor order. Up to `limit` entries. Shape is identical to a live `page.corvus.subscribeOps#op` frame."
},
"cursor": {
"type": "integer",
"description": "Cursor of the last op in `ops`. Pass this as `cursor` on the next call to continue paginating. Omitted when `ops` is empty (caller is caught up to the server's high-water for these blocks)."
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"blockIds"
],
"properties": {
"limit": {
"type": "integer",
"default": 500,
"maximum": 1000,
"minimum": 1,
"description": "Maximum number of ops to return in this page."
},
"cursor": {
"type": "integer",
"description": "Server-assigned cursor (exclusive) to resume from. Omitted = start from cursor 0 (every op the server has for the requested blocks). Same semantic as `page.corvus.subscribeOps#main.cursor`."
},
"blockIds": {
"type": "array",
"items": {
"type": "string",
"format": "at-uri"
},
"description": "The explicit set of block ids to read ops for. No transitive walk — only ops whose `blockId` is in this set are returned."
},
"includeDids": {
"type": "array",
"items": {
"type": "string",
"format": "did"
},
"description": "The dids of the users to include."
}
}
},
"description": "Read ops for the requested `blockIds` in forward cursor order, strictly after `cursor`."
}