Mettre à jour un projet avec l'API Todoist
Met à jour un projet et le renvoie. Les champs omis gardent leur valeur.
- Identifiant
- todoist_update_project
L'appel
POST https://connect.reportei.com/api/tools/todoist_update_project/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"project_id": "<project_id>"
}
}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 |
|---|---|---|---|
| project_id | string | Oui | Id of the project, from List projects. |
| name | string | Non | New name of the project. |
| description | string | Non | New description of the project. |
| color | string | Non | New color of the project.Valeurs : berry_red, red, orange, yellow, olive_green, lime_green, green, mint_green, teal, sky_blue, light_blue, blue, grape, violet, lavender, magenta, salmon, charcoal, grey, taupe |
| is_favorite | boolean | Non | Marks or unmarks the project as a favorite. |
| view_style | string | Non | How the project is displayed.Valeurs : list, board, calendar |
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_update_project. 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.
- 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.
- Mettre à jour une tâchePOSTMet à jour une tâche et la renvoie. Les champs omis gardent leur valeur. Ne déplace pas la tâche vers un autre projet ou une autre section.
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.
