Pagination

This page as markdown Whole reference as one file

List endpoints return results one page at a time. Send page_size for how many you want. Each response carries next_page_token: pass it as page_token to get the next page, and stop when it comes back empty.

Responses also carry prev_page_token, to page back, and total_size, the count across all pages.

Endpoints that page

Endpoint	Max page_size
List connected accounts	99
Search connected accounts	30
List tools	1000 (default 300)
List a user's scoped tools	No set limit
List tools available to a user	No set limit
List Virtual MCP servers	30

Good to know

Page tokens are opaque. Pass them back as they are; don't build or parse them.
Send the same filters with every page, such as connector or identifier.
The Node.js list methods take pageSize and pageToken and return nextPageToken. In Python, actions.list_tools and tools.list_scoped_tools take page_size and page_token; to page through connected accounts from Python, call the REST endpoint with page_token.

Read every page

PAGE_TOKEN=""
while :; do
  RES=$(curl -sS -G "$SCALEKIT_ENVIRONMENT_URL/api/v1/connected_accounts" \
    -H "Authorization: Bearer $TOKEN" \
    --data-urlencode "page_size=50" \
    --data-urlencode "page_token=$PAGE_TOKEN")
  echo "$RES" | jq -c '.connected_accounts[]'
  PAGE_TOKEN=$(echo "$RES" | jq -r '.next_page_token // empty')
  [ -z "$PAGE_TOKEN" ] && break
done

page_token = None
while True:
    # summary=True fills tool_names; without it, read page.tools
    page = actions.list_tools(summary=True, page_size=50, page_token=page_token)
    for name in page.tool_names:
        print(name)
    page_token = page.next_page_token
    if not page_token:
        break

let pageToken: string | undefined;
do {
  const page = await actions.listConnectedAccounts({ pageSize: 50, pageToken });
  for (const account of page.connectedAccounts) console.log(account.id);
  pageToken = page.nextPageToken || undefined;
} while (pageToken);

Response

{
  "connected_accounts": [ ... ],
  "next_page_token": "...",
  "prev_page_token": "",
  "total_size": 240
}