Supprimer une entrée de temps avec l'API Toggl Track
Supprime une entrée de temps.
- Identifiant
- toggl_delete_time_entry
L'appel
POST https://connect.reportei.com/api/tools/toggl_delete_time_entry/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"workspace_id": 1,
"time_entry_id": 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 |
|---|---|---|---|
| workspace_id | integer | Oui | Id of the workspace: the default_workspace_id from Get me, the workspace_id of a project from List projects, or the wid of a client from List clients. |
| time_entry_id | integer | Oui | Id of the time entry, from List time entries or Get current time entry. |
Connexions possibles
Votre client connecte son compte Toggl Track une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Identifiant et mot de passe
Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.
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/toggl_delete_time_entry. Il devient la définition de tool de votre agent sans conversion.
Autres tools Toggl Track
- Lister les projetsGETListe les projets de tous les workspaces de l'utilisateur, avec id, workspace_id, client_id et nom du client, indicateur billable et statut. C'est d'ici que viennent les ids de workspace. Cette route compte dans les 30 requêtes par heure que Toggl accorde à chaque utilisateur pour les routes de niveau utilisateur, quel que soit le forfait.
- Lister les clientsGETListe les clients de tous les workspaces de l'utilisateur, avec id, nom, notes, indicateur archived et l'id du workspace dans wid. Cette route compte dans les 30 requêtes par heure que Toggl accorde à chaque utilisateur pour les routes de niveau utilisateur, quel que soit le forfait.
- Créer un clientPOSTCrée un client dans un workspace. Exige name.
- Créer un projetPOSTCrée un projet dans un workspace, éventuellement pour un client. Exige name. Billable est une fonctionnalité payante.
- Mettre à jour un projetPUTMet à jour les champs envoyés d'un projet et conserve les autres. Archiver un projet correspond à active false.
- Lister les entrées de tempsGETListe les entrées de temps les plus récentes de l'utilisateur connecté, jusqu'à 1000. Pour une fenêtre, envoyez start_date et end_date ensemble ; pour des périodes entières ou d'autres personnes, utilisez Obtenir le rapport récapitulatif. Cette route compte dans les 30 requêtes par heure que Toggl accorde à chaque utilisateur pour les routes de niveau utilisateur, quel que soit le forfait.
- Obtenir l'entrée de temps en coursGETRenvoie l'entrée de temps en cours de l'utilisateur connecté, avec son id, ou null quand aucun minuteur ne tourne. Cette route compte dans les 30 requêtes par heure que Toggl accorde à chaque utilisateur pour les routes de niveau utilisateur, quel que soit le forfait.
- Créer une entrée de tempsPOSTCrée une entrée de temps pour l'utilisateur connecté. Exige workspace, workspace_id, created_with et start. Pour un minuteur en cours, envoyez duration -1 ; pour du travail passé, envoyez duration en secondes ou stop.
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.
