Collection
API & Webhooks
12 articles
01API quick startREST API at api.turgo.ai/v1 — create a key, make your first call, and learn the core concepts in 5 minutes.3 min→02Authentication and API keysBearer-token auth with scoped, workspace-bound keys — management, scopes, rotation, and security notes.3 min→03Core endpoints referenceThe resources you'll actually use — records, motion, signals, activities — and where each lives.4 min→04Rate limits and quotasPer-key request limits, how to read the headers, batch endpoints, and designing sync to stay under quota.3 min→05Pagination patternsCursor-based pagination everywhere — the loop, why cursors beat offsets, delta sync, and SDK iterators.3 min→06Webhook setupSubscribe an endpoint to events — creation, endpoint requirements, test delivery, and monitoring.3 min→07Webhook event typesThe events you can subscribe to — record, engagement, intelligence, and operational — and their payloads.3 min→08Webhook signature verificationVerify HMAC-SHA256 signatures before trusting a payload — the scheme, implementation notes, and rotation.3 min→09Retry behaviorFailed deliveries retry with backoff then dead-letter — the schedule, the DLQ, idempotency, and ordering.3 min→10Node.js SDKThe typed @turgo/sdk client — install, ergonomics, the webhook helper, and a fire-a-signal example.3 min→11Python SDKThe pip-installable turgo client — sync and async, Pydantic models, data-team patterns, and webhook verify.3 min→12API error codes referenceThe consistent error envelope — handle by code not message — with common 4xx, 5xx handling, and idempotency keys.3 min→
