Créer un commentaire avec l'API Todoist
Ajoute un commentaire à une tâche ou à un projet et le renvoie. Envoyez exactement l'un de task_id ou project_id. Les utilisateurs de uids_to_notify sont notifiés.
- Identifiant
- todoist_create_comment
L'appel
POST https://connect.reportei.com/api/tools/todoist_create_comment/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"content": "<content>"
}
}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 |
|---|---|---|---|
| content | string | Oui | Text of the comment. Markdown is supported. |
| task_id | string | Non | Id of the task to comment on, from List tasks. |
| project_id | string | Non | Id of the project to comment on, from List projects. |
| uids_to_notify | array | Non | Ids of the collaborators to notify about the comment, from List project collaborators, sent as numbers. |
Connexions possibles
Votre client connecte son compte Todoist une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/todoist, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
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/todoist_create_comment. Il devient la définition de tool de votre agent sans conversion.
Autres tools Todoist
- Lister les projetsGETListe les projets actifs auxquels le compte peut accéder. La réponse contient results et next_cursor : passez next_cursor comme cursor pour la page suivante.
- Créer un projetPOSTCrée un projet et le renvoie. Sans workspace_id c'est un projet personnel du compte.
- Mettre à jour un projetPOSTMet à jour un projet et le renvoie. Les champs omis gardent leur valeur.
- Lister les collaborateurs d'un projetGETListe les personnes qui partagent un projet, avec id, name et email. L'id est ce que prennent assignee_id et uids_to_notify.
- Lister les tâchesGETListe les tâches actives, éventuellement limitées à un projet, une section, une tâche parente ou un label. Les tâches terminées ne sont pas incluses.
- Rechercher des tâchesGETRenvoie les tâches actives qui correspondent à une query de filtre, avec la même syntaxe que les filtres de l'app. Paginez avec next_cursor.
- Obtenir une tâcheGETRenvoie une tâche active par son id. Une tâche terminée n'est pas renvoyée.
- Créer une tâchePOSTCrée une tâche et la renvoie. Sans project_id la tâche va dans l'Inbox. Définissez l'échéance avec due_string, due_date ou due_datetime.
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.
