Skip to main content

Integration patterns

PatternUse whenCallsStatus
Finished seriesYou have a window of history and want every level to draw fromPOST /v1/segmentationsAvailable
Forming seriesBars arrive live and you want each segment as it closesPOST /v1/segmentations/extend, with the edgePreview
BackfillYears of history, or bodies over 5 MBPOST /v1/segmentations/jobs, from and to your storageAvailable
WebhooksYou run jobs, or want account eventsYour endpointAvailable

Most integrations use three: a backfill once per series, extensions from its edge from then on, and webhooks for the jobs. A reporting product that redraws daily can use finished series alone.

All four use the same key, client, body hash and error handling (Requests, errors and limits).