User Story:
As a developer integrating Taskade’s API,
I want to know the exact rate limits applied to API requests,
So that I can optimize my workflows and avoid unexpected throttling or errors.
Current Issue:
While retrieving a structured list of all my AI agents across all workspaces, I encountered API rate limits, forcing me to introduce artificial delays to prevent failures.
The workflow I used:
  1. Retrieve all my workspaces via the API.
  2. For each workspace, fetch all folders.
  3. For each folder, fetch all AI agents within it.
This recursive approach resulted in multiple API calls in succession. However, at a certain point, requests started failing due to rate limits. Since these limits are not documented, I had to experiment by adding delays between requests to avoid hitting them, making the process inefficient.
Proposed Solution:
Provide clear documentation on API rate limits, including:
  • Maximum requests per minute/hour.
  • Behavior when the limit is exceeded (e.g., error codes, retry headers).
  • Recommended best practices for handling rate limits gracefully.