Les limites de débit
| Offre | Requêtes par minute et par jeton |
|---|---|
| Free Forever, Unlimited, Business | 100 |
| Business Plus | 1 000 |
| Enterprise | 10 000 |
La limite s'applique aux jetons personnels comme aux jetons OAuth. Au-delà, l'API renvoie le code HTTP 429 avec les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (heure de remise à zéro).
Jetons personnels et OAuth
- Un jeton personnel commence par pk_ ; il se génère dans Settings > Apps, section API Token, et n'expire jamais.
- Une application OAuth ne peut être créée que par le propriétaire ou un administrateur. Le jeton d'accès OAuth n'expire pas actuellement, ce qui peut changer.
- L'API ne renvoie que les informations des tâches auxquelles le titulaire du jeton a accès.
- L'usage des jetons personnels dans l'espace de travail est une permission (Personal API Tokens), accordée par défaut aux membres et administrateurs, et modifiable sur Business Plus et au-delà.
Ce que l'API renvoie par défaut
- La liste des tâches est paginée par 100 tâches par page.
- Les tâches fermées et les sous-tâches sont exclues par défaut : il faut les demander (include_closed, subtasks).
- Les tâches présentes dans plusieurs listes sont exclues par défaut de la liste qui n'est pas leur liste d'origine (include_timl).
- Les commentaires d'une tâche sont renvoyés par lots : les 25 plus récents par défaut, puis les plus anciens avec les paramètres start et start_id.
Les docs par l'API
L'import et l'export des docs en texte brut ou en Markdown ne prennent pas en charge tous les contenus : alignements, listes dépliables, checklists, bannières, éléments en ligne, vues, la plupart des contenus intégrés, colonnes, tables des matières, couleurs, couvertures, icônes, commentaires et styles de page. Les blocs de code et les tableaux perdent leur mise en forme.
Une sauvegarde qui tient compte de ces limites
Écrire son propre export par l'API demande de gérer le débit, la pagination et les cas particuliers. CYBBACK s'appuie sur l'API en suivant les limites qu'elle annonce, reprend une sauvegarde interrompue là où elle s'est arrêtée, et sauvegarde chaque liste séparément. Voir la solution ClickUp.
Questions fréquentes
Quelle est la limite de débit de l'API ClickUp ?
100 requêtes par minute et par jeton sur Free Forever, Unlimited et Business, 1 000 sur Business Plus et 10 000 sur Enterprise.
Les jetons personnels ClickUp expirent-ils ?
Non, selon la documentation développeur : les jetons personnels n'expirent jamais.
Aller plus loin
Les outils natifs couvrent les erreurs récentes. Pour garder des versions datées au-delà, restaurables et stockées en Europe ou chez vous, découvrez la sauvegarde CYBBACK.
Sources officielles
Faits vérifiés le 14/11/2026 dans la documentation officielle de l'éditeur :
- ClickUp Developer: Rate limits
- ClickUp Developer: Authentication
- ClickUp Developer: Get Tasks
- ClickUp Developer: Get Task Comments
- ClickUp Developer: Docs import and export limitations
- ClickUp Help: Default user role permissions
Guide indépendant, non affilié à l'éditeur de ClickUp. Les noms cités sont des marques de leurs propriétaires. Les interfaces évoluent : en cas de doute, la documentation officielle fait foi.