Supprimer une tâche avec l'API Asana
Supprime une tâche. Elle va dans la corbeille de l'utilisateur et peut y être restaurée dans les 30 jours.
- Identifiant
- asana_delete_task
L'appel
POST https://connect.reportei.com/api/tools/asana_delete_task/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"task_gid": "<task_gid>"
}
}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 |
|---|---|---|---|
| task_gid | string | Oui | Gid of the task, from List tasks. |
Connexions possibles
Votre client connecte son compte Asana 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/asana, 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/asana_delete_task. Il devient la définition de tool de votre agent sans conversion.
Autres tools Asana
- Lister les workspacesGETListe les workspaces et organisations que l'utilisateur peut voir. Utilisez le gid d'un élément comme workspace dans les autres tools.
- Lister les équipesGETListe les équipes d'une organisation que l'utilisateur peut voir. Un projet créé dans une organisation a besoin du gid de l'une d'elles comme team.
- Lister les projetsGETListe les projets d'un workspace. Seuls gid et name reviennent, sauf si opt_fields en demande plus. Envoyez limit pour paginer.
- Créer un projetPOSTCrée un projet et le renvoie. Les champs vont dans data, qui exige name et workspace, plus team quand le workspace est une organisation.
- Mettre à jour un projetPUTMet à jour un projet et le renvoie. Seuls les champs envoyés dans data changent.
- Lister les tâchesGETListe les tâches d'un projet ou d'une section, ou les tâches assignées à quelqu'un dans un workspace. Envoyez project, section, ou assignee avec workspace.
- Obtenir une tâcheGETRenvoie la fiche complète d'une tâche : nom, notes, responsable, dates, achèvement, projets et champs personnalisés.
- Créer une tâchePOSTCrée une tâche et la renvoie. Les champs vont dans data, qui exige workspace, projects ou parent ; projects et parent définissent déjà le workspace.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
