Rate Limits

The Tailwind API limits each API key to 5,000 requests per day. The counter resets at midnight UTC.

There is no separate per-second request limit. Requests authenticated with OAuth access tokens do not use the per-API-key counter, though scheduling actions still use the limits or credits included with your Tailwind plan.

Rate Limit Exceeded

After an API key reaches its daily limit, requests using that key receive a 429 Too Many Requests response:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily rate limit of 5000 requests exceeded. Resets at midnight UTC."
  },
  "meta": {
    "requestId": "abc123"
  }
}

The API does not currently return rate-limit or Retry-After headers. Retrying before the daily reset will continue to return 429.

Best Practices

Cache Read Responses

Cache data that does not change frequently, such as accounts and boards:

// Boards rarely change; cache them for five minutes.
const boards = await getCachedOrFetch('boards', 5 * 60 * 1000, () =>
  fetch(`${API_URL}/v1/accounts/${accountId}/boards`, options)
);

Avoid Unnecessary Requests

• Reuse account and board IDs instead of looking them up before every post.
• Follow the cursor returned by list endpoints and stop when it is null.
• Do not retry validation, authentication, or not-found errors without changing the request.

Monitor Usage

In Tailwind, open Settings > API Access and view an API key’s usage. Usage is tracked separately for each key.

Increasing Your Limit

If 5,000 requests per day is not enough for your integration, contact support@tailwindapp.com with your organization name, use case, and expected request volume.