clickup-rate-limits

# ClickUp Rate Limits ## Overview ClickUp enforces per-token, per-minute rate limits that vary by Workspace plan. When exceeded, the API returns HTTP 429 with rate limit headers. ## Rate Limit Tiers | Workspace Plan | Requests/Min/Token | Burst Support | |----------------|-------------------|---------------| | Free Forever | 100 | No | | Unlimited | 100 | No | | Business | 100 | No | | Business Plus | 1,000 | Yes | | Enterprise | 10,000 | Yes | ## Rate Limit Headers Every ClickUp API response includes these headers: | Header | Description | Example | |--------|-------------|---------| | `X-RateLimit-Limit` | Max requests in window | `100` | | `X-RateLimit-Remaining` | Requests left in window | `95` | | `X-RateLimit-Reset` | Unix timestamp when limit resets | `1695000060` | ## Exponential Backoff with Jitter ```typescript async function clickupRequestWithRetry<T>( path: string, options: RequestInit = {}, config = { maxRetries: 5, baseDelayMs: 1000, maxDelayMs: 60000 } ): Promise<T> { for (let attempt = 0; attempt <= config.maxRetries; attempt++) { const response = await fetch(`https://api.clickup.com/api/v2${path}`, { ...options, headers: { 'Authorization': process.env.CLICKUP_API_TOKEN!, 'Content-Type': 'application/json', ...options.headers, }, }); if (response.ok) return response.json(); if (response.status === 429) { // Use server-provided reset time when available const resetTimestamp...