Get started

Pagination

Collections return items and nextCursor. Pass nextCursor back as cursor until it is null.

{
  "items": [ ... ],
  "nextCursor": "3f9c2e1a-7b44-4d0e-9b1f-2a6c8d4e5f10"
}

The default limit is 50 and the maximum is 200. Ordering is ascending by UUID, with workspace and visibility filtering applied before the limit.

curl --fail-with-body "https://app.ghostgtm.ai/api/v1/definitions?limit=50" \
  -H "Authorization: Bearer $GHOST_API_KEY"

curl --fail-with-body "https://app.ghostgtm.ai/api/v1/definitions?limit=50&cursor=3f9c2e1a-7b44-4d0e-9b1f-2a6c8d4e5f10" \
  -H "Authorization: Bearer $GHOST_API_KEY"

Cursors are continuation boundaries, not snapshots. Records inserted while you page may sort before your cursor. Restart the scan when you need a fresh inventory.

Source text

Source content pages by character instead of by row: pass offset and length, and follow nextOffset until it is null.