GitDocs
Cohort-specific rate/pagination

Slack conversations.history default limit 15 maximum limit 15 May 29 2025

Sync completes without errors but silently indexes only 15 messages per page.

verified-page-readySlack Web APICollaboration SaaS APICohort-specific rate/paginationslack_rate

Agent Quick Fix

This is a Slack platform cohort limit, not a pagination bug. Code must respect the smaller page size and lower request cadence or qualify through the Marketplace path.

Product: Slack Web API
Affected: New commercially distributed Slack apps outside the Marketplace cohort after May 29, 2025, and existing installs after the later enforcement date.
Current-contract area: Slack conversations.history default/max limit drops to 15
Likely root cause: Sync completes without errors but silently indexes only 15 messages per page.
Patch:
const page = await client.conversations.history({ channel, limit: 15 });
// Persist cursor and schedule the next page after respecting Retry-After.

Validation Status

Codex searched organically in the validation run. No no-web counterfactual is attached to this page yet.

Symptom

Sync completes without errors but silently indexes only 15 messages per page.

conversations.history returns only 15 messages
429 Retry-After from conversations.history or conversations.replies

Why This Happens

This is a Slack platform cohort limit, not a pagination bug. Code must respect the smaller page size and lower request cadence or qualify through the Marketplace path.

Before And After

Before

await client.conversations.history({ channel, limit: 200 });

After

const page = await client.conversations.history({ channel, limit: 15 });
// Persist cursor and schedule the next page after respecting Retry-After.

Verification

curl -I https://slack.com/api/conversations.history

Common Wrong Fixes

  • Do not parallelize page fetches to recover the old throughput; that increases 429s and may hide dropped backfill.

Codex Search Keywords

These are the search terms observed in a neutral Codex validation run for this failure shape.

Slack conversations.history default limit 15 maximum limit 15 May 29 2025
site:docs.slack.dev/reference/methods/conversations.history limit 15
https://docs.slack.dev/reference/methods/conversations.history

Source Trail