List a page's generation runs
Returns the runs that asked for starter questions from this page, newest first, up to `limit`. Each run says how it ended and why, and which catalog record served as evidence. It carries nothing about cost or usage.
Authorization
ApiKeyAuth A WorkOS org-scoped API key, created from the dashboard's organization settings page. Identifies the tenant every read and write is scoped to. Missing, malformed, unknown, revoked, expired, or non-organization-owned keys all return 401 (no distinction, so the response can't be used to probe which keys or org ids exist).
In: header
Path Parameters
The site id (prefixed site_). A site id that isn't yours is a 404, same as any other cross-tenant id.
The page id (prefixed spg_).
Query Parameters
The page size, 1 to 100.
1 <= value <= 10050Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1/sites/string/pages/string/generations"{ "data": [ { "id": "spgr_01kvnwmagvf27rc9cze5rm9e1r", "trigger": "requested", "outcome": "written", "reason": null, "catalogReason": null, "catalogRecordTitle": "Trail shoe", "catalogRecordId": "gid://shopify/Product/8123", "candidates": 6, "questionsWritten": 3, "createdAt": "2026-10-03T09:00:00.000Z", "finishedAt": "2026-10-03T09:00:12.000Z" } ]}Delete a page
Removes the page. The starter questions it produced stay in the library, with no source page. Returns the id and a deleted flag.
List a site's starter questions
Returns the site's library in its own order, each question with the state and the 14-day performance the dashboard shows. The totals by state and by source count the whole library whatever the filters. To see what a shopper is offered on a page, send `appliesToPath` and `appliesToLanguage` (and `appliesToPageType` when the page declares one). The list then holds the switched-on questions that match the page's targeting and have text in that language, in display order, at most three as on the storefront. A page that declares no type is offered the questions that target page types, as on the storefront. Filters combine with AND. `limit` is 1 to 100 (50 by default), and a cursor is bound to the filters it was issued for.