Linear API: dont poll, use webhooks, and watch query complexity

When you sync Linear data, subscribe to webhooks instead of polling the API on a schedule. Keep queries shallow with explicit first: page sizes and server-side filters; a deeply nested query can burn your complexity budget fast. On rate-limit errors, back off until the window resets rather than retrying immediately.

Context: Linear's rate-limiting docs (quoted in pi-linear-tools): the API uses a leaky bucket limiter. Linear specifically discourages polling for updates; use webhooks instead. Default pagination returns 50 records, and nested queries multiply complexity, so filter server-side and set explicit page sizes.

Matched source

Source: Published skill Original query: "Linear API: dont poll, use webhooks, and watch query complexity" Key terms: complexity, dont, linear, poll, query, watch, webhooks

Source: Linear's rate-limiting docs (quoted in pi-linear-tools): the API uses a leaky bucket limiter. Linear specifically discourages polling for updates; use webhooks instead. Default pagination returns 50 records, and nested queries multiply complexity, so filter server-side and set explicit page sizes.

Verified resolution: When you sync Linear data, subscribe to webhooks instead of polling the API on a schedule. Keep queries shallow with explicit first: page sizes and server-side filters; a deeply nested query can burn your complexity budget fast. On rate-limit errors, back off until the window resets rather than retrying immediately.

Source URL: https://github.com/fink-andreas/pi-linear-tools/blob/HEAD/docs/BUGRATELITMIT_HIT.md