Amplify Up

POST /v1/query

Re-run a published content query with a new offset, limit, or filter.

POST
/v1/query

Re-runs a content query from the published page snapshot (for example Load more or search).

Edge base URL: https://edge.amplifyup.ai

Providers come from the published page for route. You cannot query an unpublished page, and visitors only see published content.

Body fields
NameTypeRequiredDescription
trackingIdstringYesSite tracking ID. Required if site is omitted.
sitestringNoInternal site id. Required if trackingId is omitted.
routestringYesPublished page path used to load providers and bindings.
specobjectYesFull query spec. providerId, entity, filter, sort, limit, and offset are all required.

The spec is provider-neutral — it never contains content-source query syntax. Send the whole spec, not just the parts you changed: a partial spec is rejected with 400.

Example request
Example response (200)

degraded means a content source failed and the results may be incomplete.

Errors
StatusMeaning

Prefer queryContent from the Node SDK. It fills in the endpoint, returns rows your components can edit in Composer, and takes the published spec straight off the list prop. See Lists and queries.