Skip to content

Keep retrieval limits separate from available source supply

Label bounded pages and accepted subsets without inventing a population total.

Guides

Keep retrieval limits separate from available source supply — what should the operator record?

A limit in a request or a compact response controls how much evidence is returned at that step. It does not establish the total available supply, nor does it mean omitted records were deleted. Preserve the operational limit and returned continuation state without promoting either into a source-wide population statement.

Practical operations check
Label bounded pages and accepted subsets without inventing a population total.
Distinguish requested_page_limit, actual_returned_rows and any explicitly returned total. If no authoritative total exists, store supply_total as unknown rather than copying the requested limit or the current admitted membership into that field for convenience.
Use terms such as returned records and admitted subset with the relevant receipt reference. Reserve source-total claims for actual supported totals, including their documented scope and time, rather than deriving supply from pagination behavior or local storage size.
01 / Guides

Record the limit basis

Distinguish requested_page_limit, actual_returned_rows and any explicitly returned total. If no authoritative total exists, store supply_total as unknown rather than copying the requested limit or the current admitted membership into that field for convenience.

02 / Guides

Inspect continuation evidence

Read the actual next-cursor and status context for the originating tool. A continuation indicates a supported next operation, not a numeric estimate of remaining source records or proof that every future page will contain the requested number of rows.

03 / Guides

Test summary wording

Use a fixture where the limit exceeds returned rows and no total is supplied. The summary should state the actual bounded result without describing the difference as unavailable people, missing posts or a complete inventory of the eligible population.

04 / Guides

Review stopped chains

When the operator imposes a stop, label stopped-by-operator separately from terminal continuation. Preserve the reason and accepted set instead of marking the table complete merely because no further requests are scheduled in the local workflow.

05 / Guides

Publish honest scope

Use terms such as returned records and admitted subset with the relevant receipt reference. Reserve source-total claims for actual supported totals, including their documented scope and time, rather than deriving supply from pagination behavior or local storage size.

Keep the boundaries clear.

  • Label bounded pages and accepted subsets without inventing a population total.
  • Operational record: Record the limit basis. Context badges do not certify access.

Start with a read-only check: ask your agent to report actual source coverage before collecting records or exporting an audience.

Primary references

Documentation reviewed 2026-11-15. Product capabilities, client availability and plans can change. Third-party marks identify their products, not an affiliation.

Know what social media shows about you.
Start with a question.

Get started
montage