ST-2026-128 · API endpoints & versions
Contentful CMA moves space-role collections to cursor pagination
On 14 August 2026, Contentful changes /spaces/{spaceId}/roles from offset pagination to cursor pagination, replacing total and skip response fields with pages navigation and pageNext/pagePrev requests.
Previous state
The space-roles collection used offset pagination with total and skip fields.
Current state
The endpoint returns a pages object with next and previous links; skip is replaced by pageNext and pagePrev while limit remains supported.
Affected users
Who needs to care
Contentful CMA integrations iterating /spaces/{spaceId}/roles with offset-based pagination.
Required response
What to do
Replace skip-based iteration with pageNext/pagePrev cursor handling and update response models before 14 August 2026.
Evidence boundary
What the source does not prove
This is a pagination-contract change for the space-roles collection, separate from Contentful's role-based user-response enforcement.
Lifecycle history
Dated event sequence
- Pagination change published
Contentful announced the cursor-based replacement.
- Cursor contract enforced
The space-roles endpoint moves from offset to cursor pagination.
Evidence ledger
First-party sources
- 01Contentful — Space roles collection endpoints change
Official API-change notice · 2026-05-13
Open official source ↗