Arrêter le chronomètre avec l'API Clockify
Arrête le chronomètre en cours d'un utilisateur dans un workspace, en fixant la fin de cette entrée. Exige end.
- Identifiant
- clockify_stop_timer
L'appel
POST https://connect.reportei.com/api/tools/clockify_stop_timer/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"workspaceId": "<workspaceId>",
"userId": "<userId>",
"end": "<end>"
}
}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 |
|---|---|---|---|
| workspaceId | string | Oui | Id of the workspace, from List workspaces or the activeWorkspace of Get current user. |
| userId | string | Oui | Id of the user, from Get current user for the connected user or from List users for someone else. |
| end | string | Oui | End of the running entry, as UTC in yyyy-MM-ddTHH:mm:ssZ, such as 2026-10-26T13:00:00Z. |
Connexions possibles
Votre client connecte son compte Clockify 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.
À la connexion, votre client indique aussi {region} : 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/clockify_stop_timer. Il devient la définition de tool de votre agent sans conversion.
Autres tools Clockify
- Obtenir l'utilisateur actuelGETRenvoie l'utilisateur connecté avec son id, que prennent les arguments userId, les ids des workspaces actif et par défaut, l'email et des paramètres comme le fuseau horaire.
- Lister les workspacesGETListe les workspaces de l'utilisateur connecté, avec ids, noms, devises et tarifs.
- Lister les utilisateursGETListe les utilisateurs d'un workspace avec ids, noms et emails, 50 par page. Une page de moins de 50 utilisateurs est la dernière.
- Lister les clientsGETListe les clients d'un workspace, 50 par page. Une page de moins de 50 clients est la dernière.
- Créer un clientPOSTCrée un client dans un workspace. Exige name.
- Lister les projetsGETListe les projets d'un workspace, archivés ou non, 50 par page. Une page de moins de 50 projets est la dernière.
- Créer un projetPOSTCrée un projet dans un workspace, éventuellement pour un client. Exige name.
- Lister les tâchesGETListe les tâches d'un projet, 50 par page. Une page de moins de 50 tâches est la dernière.
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.
