Skip to content

Pagination: describe page requests without a response continuation signal #25

Open

Description

@michielbdejong

ClickUp Workspace task listing exposes zero-based page and a maximum of 100 tasks per response, but its official OpenAPI response schema has only tasks: no next token/link, total count/page count, current page or documented last_page. Sources: https://developer.clickup.com/reference/getfilteredteamtasks and https://developer.clickup.com/openapi/clickup-api-v2-reference.json . Reproducible read subset: ontola/openapi-directory#263 , immutable pin de95e5bf40f54e3752281a771a786854038d683b.

The current pagination spec can declare a pageNumber request, but has no agreed description for deciding continuation solely from a result array length. Syncables derives continuation only from response token/link or counts and stops after the first page for this response. Its empty-page stop runs only after another continuation signal is present. Adding fabricated counts or an undocumented provider field would misdescribe the API. This blocks complete ClickUp task import and catalog activation.

Please discuss how the generic pagination specification should express APIs with incrementing page requests but no response continuation/count signal, and distinguish documented provider termination semantics from consumer traversal policy. Is a declared short/empty-page termination rule appropriate, and what evidence should be required when the provider only documents a maximum page size? This records the concrete gap; no new extension or provider-specific runtime workaround is proposed or implemented pending owner design feedback.

Activity

  1. michielbdejong commented on Oct 8, 2026

    @michielbdejong
    MemberAuthor

    A second related representation gap: ClickUp page starts at0, while spec §4.5 defines request role page as1-based and Syncables starts it at1. Assigning this role to ClickUp would skip the first page even with a query default0 (the generated pagination query overrides it). The offset role is not an equivalent: the provider increments a page index by1, while offset advances by item count. An accurate generic design needs to represent the initial page index alongside response-less continuation, without reinterpreting the provider's page as an item offset. Prepared ClickUp metadata will omit an unsupported scheme rather than silently skip data; catalog activation remains held.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions