Skip to content

Commit 03aafe9

Browse files
alistair3149claude
andcommitted
Trim the cursor pagination doc to the contract
The empty-page caveat narrated mechanism, and the no-total fact already lives in the Permissions section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 9009b08 commit 03aafe9

1 file changed

Lines changed: 2 additions & 4 deletions

File tree

docs/api/rest-api.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -114,10 +114,8 @@ default 10); the response carries the items and a `nextCursor`:
114114
{ "schemas": [ ... ], "nextCursor": "1462" }
115115
```
116116

117-
Pass that value back as `cursor` to fetch the next page. `nextCursor` is `null` on the last page; a non-null cursor
118-
means another page follows, though in rare cases (trailing items that fail to load) that page may come back empty.
119-
Treat the cursor as opaque and do not construct one yourself; a malformed cursor is rejected with a `400`. Cursors stay
120-
valid across item creation and deletion, and no total count is reported.
117+
Pass that value back as `cursor` to fetch the next page; `null` marks the last page. Do not construct a cursor
118+
yourself — a malformed one is rejected with a `400`. Cursors stay valid while items are created and deleted.
121119

122120
## The `expand` parameter
123121

0 commit comments

Comments
 (0)