Lister les listes de tâches avec l'API Teamwork.com
Liste les listes de tâches d'un projet. Les tâches sont créées dans une liste. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Identifiant
- teamwork_list_tasklists
L'appel
POST https://connect.reportei.com/api/tools/teamwork_list_tasklists/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"projectId": 1
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| projectId | integer | Oui | Id of the project, from List projects. |
| searchTerm | string | Non | Only task lists whose name contains this text. |
| showCompleted | boolean | Non | True to include completed task lists. |
| page | integer | Non | Page to fetch, starting at 1. |
| pageSize | integer | Non | Items per page, 50 by default and up to 500. |
Connexions possibles
Votre client connecte son compte Teamwork.com une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/teamwork, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
À la connexion, votre client indique aussi {site} : l'adresse de son compte sur l'API de l'app.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/teamwork_list_tasklists. Il devient la définition de tool de votre agent sans conversion.
Autres tools Teamwork.com
- Lister les projetsGETListe les projets auxquels l'utilisateur connecté a accès, 50 par page par défaut. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Lister les tâchesGETListe les tâches auxquelles l'utilisateur connecté a accès, dans tous les projets ou par projet, liste de tâches ou responsable, 50 par page par défaut et sans les tâches terminées sauf demande contraire. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Obtenir une tâcheGETRenvoie une tâche avec description, statut, priorité, dates, assignés, estimation et progression.
- Créer une tâchePOSTCrée une tâche dans une liste de tâches. Nécessite task avec un name. Les dates sont au format yyyy-MM-dd.
- Mettre à jour une tâchePATCHMet à jour les champs envoyés d'une tâche et conserve les autres. Pour terminer une tâche, utilisez Complete task. Les dates sont au format yyyy-MM-dd.
- Terminer une tâchePUTMarque une tâche comme terminée. C'est la route que Teamwork documente pour terminer les tâches, dans l'API v1.
- Supprimer une tâcheDELETESupprime une tâche et ses sous-tâches.
- Lister les commentaires d'une tâcheGETListe les commentaires d'une tâche. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
