PromptFloe Developer Docs
Reference

Pagination

All list endpoints use forward-only cursor pagination. Cursors are opaque tokens — never construct or modify them.

#Query parameters

FieldTypeDescription
limitnumberItems per page. Default 20, max 100.
cursorstringOpaque cursor from a previous response. Omit on first page.

#Response shape

json
{
  "data": [ /* items */ ],
  "nextCursor": "eyJpZCI6ICJhcHBfeHl6IiwgInRzIjogMTczMDAwMDAwMH0",
  "hasMore": true
}

When hasMore is false, nextCursor will be null.

#Iterating through all pages

let cursor: string | undefined;
const all: App[] = [];

do {
  const page = await client.apps.list({ limit: 100, cursor });
  all.push(...page.apps);
  cursor = page.nextCursor;
} while (cursor);

#Ordering

List endpoints return items in most-recent-first order based on the resource's primary timestamp (typically createdAt). Pagination is stable — items added during iteration appear at the start, not in the middle.

#Where to go next

PromptFloe developer docs