Référence de l'API Flowyer
Version de l'API: 216c8ec357ff
L'API REST complète de Flowyer pour les développeurs : points de terminaison, paramètres, réponses et exemples de code.
Grâce à l'API Flowyer, votre propre logiciel ou un assistant IA peut lire, créer et modifier des enregistrements (dossiers, clients, tâches, temps passés, frais et documents) au nom d'un utilisateur Flowyer. Chaque requête s'exécute avec exactement les autorisations de cet utilisateur, restreintes en outre par les étendues de la clé ou de l'autorisation d'accès. Rien ne peut être supprimé via l'API.
Les descriptions des points de terminaison et des champs sont en anglais, car les assistants IA lisent exactement le même texte.
URL de base
Tous les points de terminaison se trouvent sous les adresses ci-dessous. Utilisez toujours exactement l'hôte https commençant par www., car une redirection supprimerait l'en-tête Authorization.
URL de base
https://www.flowyer.fr/api/agent
https://www.flowyer.hu/api/agent
https://www.flowyer.com/api/agent
https://www.flowyer.ro/api/agent
https://www.flowyer.de/api/agent
https://www.flowyer.it/api/agent
https://www.flowyer.es/api/agent
Authentification
Chaque requête nécessite un jeton Bearer dans l'en-tête Authorization. Il existe deux types de jetons ; les points de terminaison les traitent de la même manière.
Clé API personnelle
L'utilisateur la crée dans Flowyer, sous Paramètres > Clés API, une fois qu'un administrateur du cabinet a activé l'API. Une clé commence par flw_, n'est affichée qu'une seule fois et peut être révoquée à tout moment avec effet immédiat.
OAuth 2.1 pour les applications connectées
Une intégration destinée à d'autres utilisateurs demande l'accès au moyen du flux OAuth 2.1 Authorization Code + PKCE (S256) au lieu d'une clé ; les clients peuvent s'enregistrer dynamiquement. Un jeton d'accès est valable 60 minutes, un jeton d'actualisation 60 jours, et la paire est remplacée à chaque utilisation. Le code_verifier PKCE comporte de 43 à 128 caractères parmi A-Z, a-z, 0-9 et - . _ ~ (RFC 7636 4.1), c'est-à-dire du base64url sans remplissage : un "=" final est refusé.
- Métadonnées du serveur
https://www.flowyer.com/.well-known/oauth-authorization-server- Autorisation
https://www.flowyer.com/authorize- Jeton
https://www.flowyer.com/api/agent/oauth/token- Enregistrement du client
https://www.flowyer.com/api/agent/oauth/register- Révocation
https://www.flowyer.com/api/agent/oauth/revoke
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/me' \
-H 'Authorization: Bearer flw_...'
Étendues
Tous les points de terminaison, sauf GET /me, exigent une étendue. Lorsque la clé ou l'autorisation d'accès ne la comporte pas, la réponse est 403 scope_missing. GET /me ne nécessite aucune étendue : utilisez-le pour voir ce que l'identifiant d'accès permet de faire.
| Étendue | Signification | Points de terminaison |
|---|---|---|
matters:read |
Consulter les dossiers | GETLister les dossiers GETLister les types de dossier GETRésoudre un dossier par son nom GETObtenir un dossier GETLister les responsables d'un dossier |
matters:create |
Créer des dossiers | POSTCréer un dossier |
matters:update |
Modifier des dossiers | PATCHMettre à jour un dossier POSTAjouter un responsable au dossier |
clients:read |
Consulter les clients | GETLister les clients GETIdentifier un client par son nom GETObtenir un client |
clients:create |
Créer des clients | POSTCréer un client |
clients:update |
Modifier des clients | PATCHModifier un client |
contacts:read |
Consulter les contacts | GETLister les contacts GETObtenir un contact GETLister les contacts d'un dossier |
contacts:create |
Créer des contacts | POSTCréer un contact |
contacts:update |
Modifier des contacts | PATCHModifier un contact |
tasks:read |
Consulter les tâches | GETLister les tâches GETObtenir une tâche |
tasks:create |
Créer des tâches | POSTCréer une tâche |
tasks:update |
Modifier des tâches | PATCHModifier une tâche POSTClôturer une tâche |
workhours:read |
Consulter les saisies de temps | GETLister les saisies de temps GETObtenir une saisie de temps |
workhours:create |
Saisir du temps | POSTEnregistrer une saisie de temps |
workhours:update |
Modifier les saisies de temps | PATCHModifier une saisie de temps |
costs:read |
Consulter les frais | GETLister les frais GETObtenir une ligne de frais |
costs:create |
Enregistrer des frais | POSTEnregistrer des frais |
costs:update |
Modifier des frais | PATCHModifier une ligne de frais |
invoices:read |
Consulter les factures | GETLister les factures GETObtenir une facture |
documents:read |
Lister les documents (métadonnées uniquement, sans téléchargement) | GETLister les documents d'un dossier GETLister les répertoires d'un dossier GETLister les versions d'un document |
documents:download |
Télécharger les documents (contenu intégral) | GETTélécharger un document |
documents:create |
Importer des documents | POSTCréer un répertoire de dossier POSTDémarrer l'import d'un document POSTTerminer l'import d'un document |
documents:update |
Renommer des documents | PATCHRenommer un document PATCHRenommer un répertoire du dossier |
colleagues:read |
Lister les membres de l'équipe (noms uniquement) | GETLister les membres de l'équipe |
knowledge:read |
Consulter la base de connaissances | GETLister les articles de la base de connaissances GETObtenir un article de la base de connaissances GETLister les catégories de la base de connaissances GETObtenir une catégorie de la base de connaissances |
knowledge:create |
Créer des entrées dans la base de connaissances | POSTCréer un article de la base de connaissances POSTCréer une catégorie de la base de connaissances |
knowledge:update |
Modifier des entrées de la base de connaissances | PATCHModifier un article de la base de connaissances PATCHModifier une catégorie de la base de connaissances |
emails:read |
Consulter les e-mails des dossiers | GETLister les e-mails d'un dossier GETObtenir un e-mail |
litigation:read |
Lister l'historique de procédure | GETLister l'historique de procédure d'un dossier |
litigation:create |
Créer des entrées d'historique de procédure | POSTCréer une entrée de l'historique de procédure |
litigation:update |
Modifier des entrées d'historique de procédure | PATCHModifier une entrée de l'historique de procédure |
mail_register:read |
Consulter le registre du courrier | GETLister le registre du courrier GETObtenir une entrée du registre du courrier |
mail_register:create |
Créer des entrées au registre du courrier | POSTCréer une entrée du registre du courrier |
mail_register:update |
Modifier des entrées du registre du courrier | PATCHModifier une entrée du registre du courrier |
comments:read |
Consulter les commentaires des dossiers | GETLister les commentaires d'un dossier |
comments:create |
Publier des commentaires sur les dossiers | POSTPublier un commentaire sur un dossier |
comments:update |
Modifier ses propres commentaires sur les dossiers | PATCHModifier son propre commentaire sur un dossier |
trials:read |
Consulter les audiences | GETLister les audiences d'un dossier GETObtenir une audience |
trials:create |
Créer des audiences | POSTCréer une audience |
trials:update |
Modifier des audiences | PATCHModifier une audience |
courts:read |
Lister les juridictions | GETLister les juridictions |
hr:read |
Consulter les absences (dates uniquement) | GETLister les absences de l'équipe |
calendar:read |
Consulter les événements de l'agenda | GETLister les événements de l'agenda GETObtenir un événement d'agenda |
calendar:create |
Créer des événements dans l'agenda | POSTCréer un événement d'agenda |
calendar:update |
Modifier des événements de l'agenda | PATCHModifier un événement d'agenda |
bookings:read |
Consulter les réservations de rendez-vous | GETLister les réservations GETObtenir une réservation |
bookings:create |
Créer des réservations de rendez-vous (envoie un e-mail au client) | POSTCréer une réservation |
bookings:update |
Reprogrammer et modifier des réservations | PATCHModifier une réservation |
bookings:send |
Confirmer ou annuler des réservations (envoie un e-mail au client) | POSTConfirmer une réservation POSTAnnuler une réservation |
tickets:read |
Consulter les tickets de support | GETLister les tickets GETObtenir un ticket |
tickets:reply |
Répondre aux tickets (envoie un e-mail au client) | POSTRépondre à un ticket |
tickets:update |
Modifier le statut des tickets | PATCHModifier le statut d'un ticket |
portal:read |
Portail client : consulter les fils de discussion et les messages | GETLister les portails clients GETLister les messages du portail |
portal:reply |
Portail client : répondre au client (publie un message et lui envoie un e-mail) | POSTRépondre dans le portail client |
Erreurs
Toutes les erreurs ont la même structure : un code machine (error), un message en anglais (message), le message dans la langue du cabinet (message_localized) et des détails facultatifs. Il est inutile de réessayer une requête inchangée en cas de 401, 403, 404 et 422, à deux exceptions près : en cas de 404 upload_not_finished, terminez d'abord l'import vers upload_url, puis appelez à nouveau complete ; en cas de jeton d'accès OAuth expiré (401 expired_key), renouvelez d'abord le jeton.
| HTTP | error | Signification |
|---|---|---|
| 400 | invalid_json use_www_host bad_request |
Requête mal formée : corps JSON invalide, hôte incorrect (utilisez l'hôte www.) ou requête illisible. |
| 401 | missing_key invalid_key revoked_key expired_key user_inactive office_not_found |
La clé est manquante, invalide, révoquée ou expirée, son titulaire n'est plus actif, ou le cabinet de la clé est introuvable. |
| 403 | scope_missing module_forbidden forbidden office_api_disabled licence_expired office_archived |
Une autorisation manque sur la clé ou sur l'utilisateur, ou le cabinet n'a pas activé l'API. |
| 404 | not_found matter_not_visible unknown_endpoint upload_not_finished replay_not_visible |
L'enregistrement n'existe pas ou l'utilisateur n'est pas autorisé à le voir ; point de terminaison inconnu ; le fichier importé n'est pas encore arrivé dans l'espace de stockage (upload_not_finished : importez-le vers upload_url, puis appelez à nouveau complete) ; ou une création répétée dont l'enregistrement a été créé auparavant mais a depuis été supprimé ou masqué (replay_not_visible : rien de nouveau n'a été créé, ne le créez pas à nouveau). |
| 405 | delete_not_allowed update_not_allowed method_not_allowed |
La suppression est impossible via l'API ; la modification n'est possible que là où la description propose une opération PATCH. |
| 409 | client_exists client_exists_generic idempotency_key_reused duplicate_in_progress record_conflict record_locked duplicate_name |
Un client portant ce nom existe déjà ; un document portant ce nom existe déjà dans le répertoire (duplicate_name) ; l'enregistrement a été modifié depuis votre lecture (record_conflict : relisez-le et renvoyez la modification avec la nouvelle valeur updated_at) ; l'enregistrement a été facturé ou verrouillé (record_locked : effectuez la modification dans Flowyer) ; l'Idempotency-Key a été utilisée sur une autre ressource ; ou une requête identique est en cours de traitement. |
| 413 | request_too_large file_too_large |
Le corps de la requête est trop volumineux (request_too_large), ou le fichier à importer dépasse la limite (file_too_large ; details.max indique la limite en octets). |
| 422 | validation_failed unknown_client unknown_colleague blocked_file_type upload_token_invalid folder_not_in_matter document_name_too_long |
Un champ invalide ou manquant (details.fields indique lequel) ; un jeton d'import invalide, déjà utilisé ou expiré (upload_token_invalid : recommencez l'import) ; ou un répertoire qui n'appartient pas au dossier (folder_not_in_matter). |
| 429 | rate_limited auth_rate_limited |
Trop de requêtes (300 par minute et par clé) ; l'en-tête Retry-After indique quand réessayer. |
| 500 | server_error |
Erreur inattendue. La requête a été journalisée sous son request_id ; réessayez plus tard et, si l'erreur se reproduit, communiquez cet identifiant au support Flowyer. |
| 503 | office_maintenance office_setup_incomplete temporarily_unavailable |
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; l'en-tête Retry-After indique quand réessayer. |
Exemples de réponses · 403
{
"error": "scope_missing",
"message": "This API key does not have the \"clients:create\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"clients:create\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "clients:create"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Pagination
Les listes d'enregistrements sont paginées avec les paramètres limit et offset (par défaut 25, au maximum 100 éléments par page). pagination.total correspond au nombre total de résultats ; l'offset de la page suivante est égal à l'offset précédent plus limit. GET /colleagues, GET /clients/resolve et GET /matters/resolve ne sont pas paginés : ils n'acceptent que limit (avec leurs propres valeurs par défaut et maximum, voir le point de terminaison) et renvoient total et truncated dans data au lieu d'un objet pagination ; ne leur envoyez donc pas d'offset.
Exemples de réponses · 200
{
"data": [
{
"id": 1234,
"...": "..."
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 134
}
}
Nouvelles tentatives sûres
Chaque création accepte un en-tête Idempotency-Key (ou un champ idempotency_key). Une requête répétée avec la même valeur renvoie l'enregistrement créé la première fois (200, idempotent_replay) au lieu d'en créer un autre. Des clés différentes créent toujours des enregistrements différents. Sans clé, une création identique dans un délai de 120 secondes renvoie le premier enregistrement.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/clients' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{"name": "Kovács Kft."}'
Modifications et conflits
Une modification est une requête PATCH sur le chemin propre de l'enregistrement : seuls les champs envoyés changent, et un null explicite efface un champ lorsque la description du champ le permet ; pour certains champs, null conserve la valeur enregistrée, lisez donc la description du champ. Envoyez dans expected_updated_at la valeur updated_at de votre dernière lecture. Si quelqu'un d'autre a modifié l'enregistrement entre-temps, la réponse est 409 record_conflict ; relisez l'enregistrement avant de réessayer.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/matters/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{"expected_updated_at": "2026-10-30T09:15:00+01:00", "description": null}'
Dates et fuseau horaire
Les dates sont au format AAAA-MM-JJ, les horodatages au format ISO 8601 avec le décalage du fuseau horaire du cabinet. Le fuseau horaire du cabinet figure dans le champ office.timezone de GET /me.
Limites
300 requêtes par minute au maximum par clé ou par jeton ; au-delà, la réponse est 429 et l'en-tête Retry-After indique quand réessayer. Le corps d'une requête JSON ne peut dépasser 64 Ko, et un document importé 100 Mo.
Versions
La version de la description OpenAPI change à chaque modification et est également envoyée dans l'en-tête ETag, de sorte que les clients automatisés peuvent vérifier avec If-None-Match si elle a changé.
Moi
Qui suis-je
/api/agent/me
Renvoie l'utilisateur et le cabinet pour lesquels agit cette clé API, les étendues de la clé (ce qu'elle peut faire) et les limites de débit. Appelez-la en premier pour savoir quelles opérations sont disponibles ; aucune étendue n'est requise.
Ce point de terminaison n'accepte aucune donnée en entrée.
Réponses
200
OK.
dataobligatoireChamps de data
userChamps de user
idnamelanguageofficeChamps de office
idnametimezoneFuseau IANA dans lequel l'API lit et écrit les horodatages, par exemple Europe/Budapest.
currency_idLa devise du cabinet (identifiant de devise Flowyer) : costs.create comptabilise dans cette devise lorsque currency_id est omis.
currencyCode ISO de la devise du cabinet, par exemple HUF, EUR, RON.
keyChamps de key
idnameNom que l'utilisateur a donné à cette clé, ou l'application connectée pour un jeton OAuth.
kind"key" = une clé API statique, "oauth" = un jeton d'accès OAuth 2.1.
"key" "oauth" prefixPremiers caractères d'une clé statique, à des fins d'identification uniquement ; null pour OAuth.
expires_atlast_used_atscopesÉtendues de cet identifiant d'accès, par exemple "matters:read". Une opération dont l'étendue manque répond 403.
available_scopesToutes les étendues que le titulaire de la clé pourrait activer dans Flowyer.
limitsChamps de limits
requests_per_minutelist_max_limitchannelComment la requête est parvenue à Flowyer.
"rest" "mcp"
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Paramètre de requête inconnu (cette opération n'en accepte aucun) ; details.fields l'indique.
details.fields l'indique.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/me' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/me", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/me",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"user": {
"id": 1234,
"name": "string",
"language": "string"
},
"office": {
"id": 1234,
"name": "string",
"timezone": "string",
"currency_id": 1234,
"currency": "string"
},
"key": {
"id": 1234,
"name": "string",
"kind": "key",
"prefix": "string",
"expires_at": "2026-10-30T09:15:00+01:00",
"last_used_at": "2026-10-30T09:15:00+01:00"
},
"scopes": [
"string"
],
"available_scopes": [
"string"
],
"limits": {
"requests_per_minute": 0,
"list_max_limit": 0
},
"channel": "rest"
}
}
{
"error": "invalid_key",
"message": "The API key is not valid.",
"message_localized": "La clé API n'est pas valide.",
"locale": "fr",
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Équipe
Lister les membres de l'équipe
/api/agent/colleagues
Liste les membres actifs de l'équipe du cabinet (id, nom) pour assigned_to_user_id / responsible_user_id. Avec q (un nom tel qu'entendu ; accents, casse et petites fautes de frappe tolérés), renvoie le statut exact/similar/none comme les outils d'identification : seul "exact" peut être utilisé directement en toute sécurité.
Paramètres de requête
qNom du membre de l'équipe à rechercher, tel qu'entendu ou dicté, dans n'importe quel ordre des mots. Omettez-le pour lister tous les membres actifs de l'équipe.
"Nagy Péter"limitNombre maximal de membres de l'équipe à renvoyer (par défaut 200).
200Réponses
200
OK.
dataobligatoireChamps de data
statusUniquement avec q : exact = une correspondance sûre (son id peut être utilisé en toute sécurité), similar = correspondance approchante ou multiple (à confirmer d'abord avec l'utilisateur), none = aucune correspondance (interrogez l'utilisateur). Null sans q.
"exact" "similar" "none" colleaguesMembres actifs de l'équipe, meilleure correspondance en premier avec q, sinon par nom.
Champs de colleagues
idId de l'utilisateur : transmettez-le comme assigned_to_user_id / responsible_user_id.
nameNom affiché tel que Flowyer le présente (avec le titre, le cas échéant).
titleTitre précédant le nom, par exemple "Dr.", ou null.
totalNombre de membres de l'équipe correspondants (tous les membres actifs sans q) avant que la liste ne soit tronquée à limit.
truncatedTrue lorsque plus de membres de l'équipe correspondaient que ceux renvoyés : affinez q ou augmentez limit.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/colleagues?q=Nagy%20P%C3%A9ter' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/colleagues?q=Nagy%20P%C3%A9ter", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/colleagues?q=Nagy%20P%C3%A9ter",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"status": "exact",
"colleagues": [
{
"id": 1234,
"name": "string",
"title": "string"
}
],
"total": 1,
"truncated": true
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"colleagues:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"colleagues:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "colleagues:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Dossiers
Lister les dossiers
/api/agent/matters
Liste les dossiers que l'utilisateur peut voir, des plus récents aux plus anciens. Utilisez-la pour trouver un dossier par numéro de dossier, objet ou client avant d'y faire référence ailleurs. Les dossiers archivés sont masqués, sauf si include_archived vaut true.
Paramètres de requête
qRecherche en texte libre dans l'objet et les noms des clients (sans tenir compte des accents ni de la casse) et dans les autres numéros de dossier du cabinet ; ou un numéro de dossier, soit exactement tel que renvoyé dans case_number (le schéma de numérotation du cabinet), soit sous la forme année/numéro d'ordre, par exemple "2026/0025".
"2026/0025"client_idUniquement les dossiers de ce client.
512responsible_user_idUniquement les dossiers dont cet utilisateur (identifiants issus de colleagues.list) est responsable : comme responsable principal, responsable supplémentaire ou membre d'un groupe de travail responsable (comme le filtre par membre de l'équipe de l'interface web).
updated_sinceUniquement les dossiers modifiés à partir de cet instant (ISO 8601).
"2026-10-01T00:00:00+02:00"include_archivedInclure les dossiers archivés.
falselimitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du dossier. Utilisez-le ailleurs en tant que matter_id.
1234case_numberNuméro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.
"2026/0025"subject"Kovács Kft. v. Nagy Bt. - contract dispute"status"active" "archived" case_type_idcase_typeNom localisé du type de dossier.
responsible_user_idresponsibleNom affiché de l'avocat responsable.
clientsClients (mandants) du dossier.
Champs de clients
idnamestarted_onrestrictedTrue lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
created_atupdated_atcreated_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters?q=2026%2F0025&client_id=512&updated_since=2026-10-01T00%3A00%3A00%2B02%3A00' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters?q=2026%2F0025&client_id=512&updated_since=2026-10-01T00%3A00%3A00%2B02%3A00", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters?q=2026%2F0025&client_id=512&updated_since=2026-10-01T00%3A00%3A00%2B02%3A00",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"case_number": "2026/0025",
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"status": "active",
"case_type_id": 1234,
"case_type": "string",
"responsible_user_id": 1234,
"responsible": "string",
"clients": [
{
"id": 1234,
"name": "string"
}
],
"started_on": "2026-10-30",
"restricted": true,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"matters:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"matters:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "matters:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les types de dossier
/api/agent/case-types
Liste les types de dossier Flowyer (domaines du droit) sous la forme identifiant + nom dans la langue du cabinet, pour le case_type_id de matters.create : faites correspondre les termes de l'utilisateur à un nom et transmettez cet identifiant. Récupérez cette liste une fois au lieu de deviner ; l'espace réservé "-" (identifiant 0) est exclu.
Ce point de terminaison n'accepte aucune donnée en entrée.
Réponses
200
OK.
dataobligatoireChamps de data
case_typesLes types de dossier Flowyer, triés par nom.
Champs de case_types
idIdentifiant du type de dossier : transmettez-le en tant que case_type_id à matters.create.
nameNom du type de dossier (domaine du droit) dans la langue du cabinet.
totalNombre de types de dossier renvoyés.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Paramètre de requête inconnu (cette opération n'en accepte aucun) ; details.fields l'indique.
details.fields l'indique.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/case-types' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/case-types", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/case-types",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"case_types": [
{
"id": 1234,
"name": "string"
}
],
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"matters:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"matters:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "matters:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Résoudre un dossier par son nom
/api/agent/matters/resolve
Trouve un dossier à partir d'un objet ou d'un nom de client prononcé ou mal orthographié (accents, casse et petites fautes de frappe tolérés). Renvoie le statut exact/similar/none et les candidats. Seul "exact" peut être utilisé directement en toute sécurité ; sinon, confirmez avec l'utilisateur. De nombreux résultats similaires ne sont jamais "exact" : affinez avec client_id ou un nom plus complet.
Paramètres de requête
nameobligatoireObjet du dossier ou nom du client à rechercher, tel qu'entendu ou dicté.
"ingatlan adásvétel"client_idUniquement les dossiers de ce client (à utiliser après que clients.resolve a renvoyé un client exact).
limitNombre maximal de candidats à renvoyer (par défaut 5).
5Réponses
200
OK.
dataobligatoireChamps de data
statusexact = une correspondance sûre (son id peut être utilisé en toute sécurité). similar = une ou plusieurs correspondances approchantes, à confirmer d'abord avec l'utilisateur. none = aucune correspondance, interrogez l'utilisateur.
"exact" "similar" "none" mattersDossiers candidats, meilleure correspondance en premier.
Champs de matters
idIdentifiant du dossier. Utilisez-le ailleurs en tant que matter_id.
1234case_numberNuméro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.
"2026/0025"subject"Kovács Kft. v. Nagy Bt. - contract dispute"status"active" "archived" case_type_idcase_typeNom localisé du type de dossier.
responsible_user_idresponsibleNom affiché de l'avocat responsable.
clientsClients (mandants) du dossier.
Champs de clients
idnamestarted_onrestrictedTrue lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
created_atupdated_atcreated_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserattotalNombre de dossiers correspondants avant que la liste ne soit tronquée à limit.
truncatedTrue lorsque plus de dossiers correspondaient que ceux renvoyés, ou qu'il existait trop de résultats similaires pour tous les vérifier ; affinez avec client_id ou un nom plus complet, ou augmentez limit, plutôt que de choisir dans une liste incomplète.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/resolve?name=ingatlan%20ad%C3%A1sv%C3%A9tel' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/resolve?name=ingatlan%20ad%C3%A1sv%C3%A9tel", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/resolve?name=ingatlan%20ad%C3%A1sv%C3%A9tel",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"status": "exact",
"matters": [
{
"id": 1234,
"case_number": "2026/0025",
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"status": "active",
"case_type_id": 1234,
"case_type": "string",
"responsible_user_id": 1234,
"responsible": "string",
"clients": [
{
"id": 1234,
"name": "string"
}
],
"started_on": "2026-10-30",
"restricted": true,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"total": 1,
"truncated": true
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"matters:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"matters:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "matters:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un dossier
/api/agent/matters/{id}
Renvoie un dossier avec ses clients et ses détails. Répond 404 lorsque le dossier n'existe pas ou que l'utilisateur ne peut pas le voir.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du dossier. Utilisez-le ailleurs en tant que matter_id.
1234case_numberNuméro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.
"2026/0025"subject"Kovács Kft. v. Nagy Bt. - contract dispute"status"active" "archived" case_type_idcase_typeNom localisé du type de dossier.
responsible_user_idresponsibleNom affiché de l'avocat responsable.
clientsClients (mandants) du dossier.
Champs de clients
idnamestarted_onrestrictedTrue lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
created_atupdated_atcreated_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratdescriptionlitigiousarchived_atJour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 1234,
"case_number": "2026/0025",
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"status": "active",
"case_type_id": 1234,
"case_type": "string",
"responsible_user_id": 1234,
"responsible": "string",
"clients": [
{
"id": 1234,
"name": "string"
}
],
"started_on": "2026-10-30",
"restricted": true,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"description": "string",
"litigious": true,
"archived_at": "2026-10-30"
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer un dossier
/api/agent/matters
Ouvre un dossier avec le numéro de dossier suivant de l'année. Nécessite au moins un client existant (recherchez-le ou créez-le d'abord). L'avocat responsable est par défaut l'utilisateur de la clé ; dans le cas contraire, il est notifié. Les parties, les contacts et les honoraires se définissent dans Flowyer.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
subjectobligatoireIntitulé court du dossier tel qu'il apparaît dans les listes. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Kovács Kft. v. Nagy Bt. - contract dispute"case_type_idobligatoireIdentifiant du type de dossier (domaine du droit). Listez les identifiants et noms valides avec case_types.list et choisissez celui qui correspond aux termes de l'utilisateur, ou demandez à l'utilisateur de choisir par nom. Un identifiant inconnu renvoie toujours 422 avec details.known_case_types ; un dossier existant indique son type dans matters.get case_type_id / case_type.
client_idsobligatoireIdentifiants des clients (mandants). Au moins un, au plus 20.
[
512
]responsible_user_idAvocat responsable : un identifiant d'utilisateur issu de colleagues.list (recherchez-y un nom dicté). Par défaut : l'utilisateur titulaire de la clé.
started_onDate de début, YYYY-MM-DD. Par défaut : aujourd'hui.
"2026-10-29"descriptionDescription plus longue, texte brut.
main_case_numberNuméro de référence principal propre au cabinet pour le dossier. Obligatoire lorsque le schéma de numérotation du cabinet l'utilise (sinon l'API répond 422).
restrictedtrue = seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
falseidempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idIdentifiant du dossier. Utilisez-le ailleurs en tant que matter_id.
1234case_numberNuméro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.
"2026/0025"subject"Kovács Kft. v. Nagy Bt. - contract dispute"status"active" "archived" case_type_idcase_typeNom localisé du type de dossier.
responsible_user_idresponsibleNom affiché de l'avocat responsable.
clientsClients (mandants) du dossier.
Champs de clients
idnamestarted_onrestrictedTrue lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
created_atupdated_atcreated_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratdescriptionlitigiousarchived_atJour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
createdtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idIdentifiant du dossier. Utilisez-le ailleurs en tant que matter_id.
1234case_numberNuméro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.
"2026/0025"subject"Kovács Kft. v. Nagy Bt. - contract dispute"status"active" "archived" case_type_idcase_typeNom localisé du type de dossier.
responsible_user_idresponsibleNom affiché de l'avocat responsable.
clientsClients (mandants) du dossier.
Champs de clients
idnamestarted_onrestrictedTrue lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
created_atupdated_atcreated_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratdescriptionlitigiousarchived_atJour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
createdfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"case_type_id": 1234,
"client_ids": [
512
],
"started_on": "2026-10-29"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"case_type_id": 1234,
"client_ids": [
512
],
"started_on": "2026-10-29"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"case_type_id": 1234,
"client_ids": [
512,
],
"started_on": "2026-10-29",
},
timeout=30,
)
print(response.status_code, response.json())
{
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"case_type_id": 1234,
"client_ids": [
512
],
"started_on": "2026-10-29"
}
Exemples de réponses
{
"data": {
"id": 1234,
"case_number": "2026/0025",
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"status": "active",
"case_type_id": 1234,
"case_type": "string",
"responsible_user_id": 1234,
"responsible": "string",
"clients": [
{
"id": 1234,
"name": "string"
}
],
"started_on": "2026-10-30",
"restricted": true,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"description": "string",
"litigious": true,
"archived_at": "2026-10-30"
},
"created": true
}
{
"data": {
"id": 1234,
"case_number": "2026/0025",
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"status": "active",
"case_type_id": 1234,
"case_type": "string",
"responsible_user_id": 1234,
"responsible": "string",
"clients": [
{
"id": 1234,
"name": "string"
}
],
"started_on": "2026-10-30",
"restricted": true,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"description": "string",
"litigious": true,
"archived_at": "2026-10-30"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"subject": [
"Le champ subject est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Mettre à jour un dossier
/api/agent/matters/{id}
Modifie l'objet, la description, la date de début, l'indicateur contentieux ou l'avocat responsable d'un dossier. Le numéro de dossier, la muraille de Chine, le statut d'archivage, les honoraires et les liens avec les clients ne sont pas modifiables ici. Transmettez expected_updated_at issu de votre dernière lecture ; une modification concurrente renvoie 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
subjectIntitulé court du dossier. Texte brut, 255 caractères au plus pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas non plus être introduits, mais un objet enregistré plus long ou qui les contient peut être renvoyé tel quel. null conserve l'objet actuel.
descriptionDescription plus longue, texte brut, 10000 caractères au plus pour une NOUVELLE valeur ; une description enregistrée plus longue peut être renvoyée telle quelle.
started_onDate de début, YYYY-MM-DD. null conserve la valeur actuelle (une date de début ne peut pas être effacée).
litigiousIndique si le dossier est contentieux.
responsible_user_idNouvel avocat responsable : l'identifiant d'utilisateur d'un membre actif de l'équipe, issu de colleagues.list. Il est notifié s'il ne s'agit pas de vous. Envoyer la valeur actuelle - ou null / 0, valeur relue pour un dossier sans responsable - ne modifie rien.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
idIdentifiant du dossier. Utilisez-le ailleurs en tant que matter_id.
1234case_numberNuméro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.
"2026/0025"subject"Kovács Kft. v. Nagy Bt. - contract dispute"status"active" "archived" case_type_idcase_typeNom localisé du type de dossier.
responsible_user_idresponsibleNom affiché de l'avocat responsable.
clientsClients (mandants) du dossier.
Champs de clients
idnamestarted_onrestrictedTrue lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).
created_atupdated_atcreated_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratdescriptionlitigiousarchived_atJour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
updatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/matters/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/matters/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string"
}
Exemples de réponses
{
"data": {
"id": 1234,
"case_number": "2026/0025",
"subject": "Kovács Kft. v. Nagy Bt. - contract dispute",
"status": "active",
"case_type_id": 1234,
"case_type": "string",
"responsible_user_id": 1234,
"responsible": "string",
"clients": [
{
"id": 1234,
"name": "string"
}
],
"started_on": "2026-10-30",
"restricted": true,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"description": "string",
"litigious": true,
"archived_at": "2026-10-30"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les responsables d'un dossier
/api/agent/matters/{id}/responsibles
Liste les responsables SUPPLÉMENTAIRES d'un dossier (le responsable principal figure dans matters.get) : chacun est un membre de l'équipe (type "user", user_id renseigné) ou un groupe de travail (type "workgroup", workgroup_id renseigné), qui peuvent tous voir le dossier. Répond 404 lorsque le dossier n'est pas visible.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
type"user" = un seul membre de l'équipe ; "workgroup" = tous les membres d'un groupe de travail.
"user" "workgroup" user_idIdentifiant d'utilisateur du membre de l'équipe pour une entrée "user" (transmettez-le en tant que user_id à matters.responsibles.add) ; null pour un groupe de travail.
workgroup_idIdentifiant du groupe de travail pour une entrée "workgroup" ; null pour un membre de l'équipe seul. Les groupes de travail responsables se gèrent dans Flowyer.
nameNom affiché du membre de l'équipe ou du groupe de travail.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/responsibles?limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/responsibles?limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/responsibles?limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"type": "user",
"user_id": 1234,
"workgroup_id": 1234,
"name": "string"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Ajouter un responsable au dossier
/api/agent/matters/{id}/responsibles
Ajoute un membre de l'équipe (user_id issu de colleagues.list) comme responsable supplémentaire d'un dossier. Cela DONNE à ce membre de l'équipe l'accès au dossier : n'ajoutez donc qu'une personne qui doit le voir ; elle est notifiée. Idempotent : ajouter de nouveau un responsable existant ne modifie rien.
Paramètres de chemin
idobligatoireDossier dont le membre de l'équipe devient responsable (il doit être visible).
1234Corps de la requête application/json
user_idobligatoireMembre de l'équipe à ajouter : un identifiant d'utilisateur issu de colleagues.list. Son ajout lui donne accès au dossier.
42Réponses
200
OK.
dataobligatoireChamps de data
user_idLe membre de l'équipe désormais responsable du dossier.
nameNom affiché du membre de l'équipe.
already_responsibleTrue lorsque le membre de l'équipe était déjà responsable du dossier (rien n'a changé).
notifiedTrue lorsque le membre de l'équipe a été notifié de son ajout. Jamais true lorsque le membre de l'équipe est vous-même, ou lorsqu'il était déjà responsable.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/responsibles' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"user_id": 42
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/responsibles", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"user_id": 42
}),
});
const result = await response.json();
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/responsibles",
headers={
"Authorization": "Bearer flw_...",
},
json={
"user_id": 42,
},
timeout=30,
)
print(response.status_code, response.json())
{
"user_id": 42
}
Exemples de réponses
{
"data": {
"user_id": 1234,
"name": "string",
"already_responsible": true,
"notified": true
}
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"user_id": [
"Le champ user id est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Clients
Lister les clients
/api/agent/clients
Liste les clients du cabinet (personnes physiques et sociétés), par ordre alphabétique ; q recherche dans le nom (sans tenir compte des accents ni de la casse), l'e-mail et le numéro d'identification fiscale. Avant de créer un client, vérifiez le nom avec clients.resolve (qui tolère aussi les fautes de frappe). Les clients archivés sont masqués, sauf si include_archived vaut true.
Paramètres de requête
qRechercher dans le nom (sans tenir compte des accents ni de la casse), l'e-mail et le numéro d'identification fiscale.
"Kovács"is_persontrue = personnes physiques uniquement, false = sociétés uniquement.
include_archivedfalselimitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idId du client. Utilisez-le comme client_id ailleurs.
512name"Kovács Kft."is_personTrue pour une personne physique, false pour une société.
emailphonearchivedrecorded_by_user_idrecorded_bycreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/clients?q=Kov%C3%A1cs&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/clients?q=Kov%C3%A1cs&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/clients?q=Kov%C3%A1cs&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 512,
"name": "Kovács Kft.",
"is_person": true,
"email": "info@example.hu",
"phone": "string",
"archived": true,
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"clients:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"clients:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "clients:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Identifier un client par son nom
/api/agent/clients/resolve
Trouve un client à partir d'un nom prononcé ou mal orthographié (accents, casse et petites fautes de frappe tolérés). Renvoie le statut exact/similar/none et les clients candidats. Seul "exact" peut être utilisé directement en toute sécurité ; en cas de "similar" ou "none", interrogez l'utilisateur. Un nom ayant de nombreux homonymes approchants n'est jamais "exact" : demandez un nom plus complet.
Paramètres de requête
nameobligatoireNom du client à rechercher, tel qu'entendu ou dicté.
"Józsi ingatlan"limitNombre maximal de candidats à renvoyer (par défaut 5).
5Réponses
200
OK.
dataobligatoireChamps de data
statusexact = une correspondance sûre (son id peut être utilisé en toute sécurité). similar = une ou plusieurs correspondances approchantes, à confirmer d'abord avec l'utilisateur. none = aucune correspondance, interrogez l'utilisateur.
"exact" "similar" "none" matchesClients candidats, meilleure correspondance en premier.
Champs de matches
idId du client. Utilisez-le comme client_id ailleurs.
512name"Kovács Kft."is_personTrue pour une personne physique, false pour une société.
emailphonearchivedrecorded_by_user_idrecorded_bycreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserattotalNombre de clients correspondants avant que la liste ne soit tronquée à limit.
truncatedTrue lorsque plus de clients correspondaient que ceux renvoyés, ou que les noms approchants étaient trop nombreux pour être tous vérifiés ; demandez à l'utilisateur un nom plus complet ou augmentez limit plutôt que de choisir dans une liste incomplète.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/clients/resolve?name=J%C3%B3zsi%20ingatlan' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/clients/resolve?name=J%C3%B3zsi%20ingatlan", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/clients/resolve?name=J%C3%B3zsi%20ingatlan",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"status": "exact",
"matches": [
{
"id": 512,
"name": "Kovács Kft.",
"is_person": true,
"email": "info@example.hu",
"phone": "string",
"archived": true,
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"total": 1,
"truncated": true
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"clients:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"clients:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "clients:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un client
/api/agent/clients/{id}
Renvoie un client avec son adresse et ses données d'immatriculation. Les numéros de pièces d'identité et les paramètres d'honoraires ne sont jamais renvoyés.
Paramètres de chemin
idobligatoireId du client.
512Réponses
200
OK.
dataobligatoireChamps de data
idId du client. Utilisez-le comme client_id ailleurs.
512name"Kovács Kft."is_personTrue pour une personne physique, false pour une société.
emailphonearchivedrecorded_by_user_idrecorded_bycreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserataddressChamps de address
zipcitystreetmailing_addressChamps de mailing_address
zipcitystreettax_numberSociétés uniquement ; null pour une personne physique.
company_registration_numberSociétés uniquement ; null pour une personne physique.
representative_nameSociétés uniquement ; null pour une personne physique.
representative_positionSociétés uniquement ; null pour une personne physique.
main_activityActivité principale. Sociétés uniquement ; null pour une personne physique.
nationality_countrynote
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/clients/512' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/clients/512", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/clients/512",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 512,
"name": "Kovács Kft.",
"is_person": true,
"email": "info@example.hu",
"phone": "string",
"archived": true,
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"address": {
"zip": "string",
"city": "string",
"street": "string"
},
"mailing_address": {
"zip": "string",
"city": "string",
"street": "string"
},
"tax_number": "string",
"company_registration_number": "string",
"representative_name": "string",
"representative_position": "string",
"main_activity": "string",
"nationality_country": "string",
"note": "string"
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"client_id": 512
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer un client
/api/agent/clients
Crée un client (personne physique ou société), enregistré comme créé par l'utilisateur de la clé. Vérifiez d'abord le nom avec clients.resolve (qui tolère l'absence d'accents et les fautes de frappe) : un 409 ne détecte qu'un client actif portant exactement le même nom, sauf si allow_duplicate_name vaut true. Les numéros de pièces d'identité et les honoraires ne peuvent pas être définis.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
nameobligatoireNom complet de la personne ou dénomination de la société. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Kovács Kft."is_persontrue pour une personne physique, false (par défaut) pour une société.
falseemail"info@kovacskft.hu"phone"+36 1 234 5678"addressSiège social / adresse du domicile.
Champs de address
zipcitystreetmailing_addressChamps de mailing_address
zipcitystreettax_numberNuméro d'identification fiscale de la société (sociétés uniquement).
"12345678-2-41"company_registration_numberNuméro d'immatriculation de la société (sociétés uniquement).
"01-09-123456"representative_nameSociétés uniquement.
representative_positionSociétés uniquement.
main_activityActivité principale (sociétés uniquement).
nationality_countrynoteallow_duplicate_nameCréer même si un client actif portant le même nom existe.
falseidempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idId du client. Utilisez-le comme client_id ailleurs.
512name"Kovács Kft."is_personTrue pour une personne physique, false pour une société.
emailphonearchivedrecorded_by_user_idrecorded_bycreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserataddressChamps de address
zipcitystreetmailing_addressChamps de mailing_address
zipcitystreettax_numberSociétés uniquement ; null pour une personne physique.
company_registration_numberSociétés uniquement ; null pour une personne physique.
representative_nameSociétés uniquement ; null pour une personne physique.
representative_positionSociétés uniquement ; null pour une personne physique.
main_activityActivité principale. Sociétés uniquement ; null pour une personne physique.
nationality_countrynotecreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idId du client. Utilisez-le comme client_id ailleurs.
512name"Kovács Kft."is_personTrue pour une personne physique, false pour une société.
emailphonearchivedrecorded_by_user_idrecorded_bycreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserataddressChamps de address
zipcitystreetmailing_addressChamps de mailing_address
zipcitystreettax_numberSociétés uniquement ; null pour une personne physique.
company_registration_numberSociétés uniquement ; null pour une personne physique.
representative_nameSociétés uniquement ; null pour une personne physique.
representative_positionSociétés uniquement ; null pour une personne physique.
main_activityActivité principale. Sociétés uniquement ; null pour une personne physique.
nationality_countrynotecreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
Un client actif portant le même nom existe (client_exists, ou client_exists_generic sans l'étendue clients:read, lorsque le client existant ne peut pas être nommé ; transmettez allow_duplicate_name pour passer outre), l'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress).
client_exists, ou client_exists_generic sans l'étendue clients:read, lorsque le client existant ne peut pas être nommé ; transmettez allow_duplicate_name pour passer outre), l'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/clients' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"name": "Kovács Kft.",
"email": "info@kovacskft.hu",
"phone": "+36 1 234 5678",
"tax_number": "12345678-2-41",
"company_registration_number": "01-09-123456"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/clients", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"name": "Kovács Kft.",
"email": "info@kovacskft.hu",
"phone": "+36 1 234 5678",
"tax_number": "12345678-2-41",
"company_registration_number": "01-09-123456"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/clients",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"name": "Kovács Kft.",
"email": "info@kovacskft.hu",
"phone": "+36 1 234 5678",
"tax_number": "12345678-2-41",
"company_registration_number": "01-09-123456",
},
timeout=30,
)
print(response.status_code, response.json())
{
"name": "Kovács Kft.",
"email": "info@kovacskft.hu",
"phone": "+36 1 234 5678",
"tax_number": "12345678-2-41",
"company_registration_number": "01-09-123456"
}
Exemples de réponses
{
"data": {
"id": 512,
"name": "Kovács Kft.",
"is_person": true,
"email": "info@example.hu",
"phone": "string",
"archived": true,
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"address": {
"zip": "string",
"city": "string",
"street": "string"
},
"mailing_address": {
"zip": "string",
"city": "string",
"street": "string"
},
"tax_number": "string",
"company_registration_number": "string",
"representative_name": "string",
"representative_position": "string",
"main_activity": "string",
"nationality_country": "string",
"note": "string"
},
"created": true
}
{
"data": {
"id": 512,
"name": "Kovács Kft.",
"is_person": true,
"email": "info@example.hu",
"phone": "string",
"archived": true,
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"address": {
"zip": "string",
"city": "string",
"street": "string"
},
"mailing_address": {
"zip": "string",
"city": "string",
"street": "string"
},
"tax_number": "string",
"company_registration_number": "string",
"representative_name": "string",
"representative_position": "string",
"main_activity": "string",
"nationality_country": "string",
"note": "string"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"name": [
"Le champ name est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier un client
/api/agent/clients/{id}
Modifie les coordonnées d'un client (nom, e-mail, téléphone, adresse, note, nationalité, ainsi que représentant/activité de la société). Les numéros de pièces d'identité, numéros d'identification fiscale, honoraires et le type personne physique/société ne sont pas modifiables ici. Transmettez expected_updated_at ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
nameNom complet ou dénomination sociale. Texte brut, 255 caractères au maximum pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas non plus être introduits, mais un nom stocké plus long ou qui en contient peut être renvoyé tel quel. null conserve le nom actuel.
emailphoneaddressSiège social / adresse du domicile.
Champs de address
zipcitystreetmailing_addressChamps de mailing_address
zipcitystreetrepresentative_nameSociétés uniquement.
representative_positionSociétés uniquement.
main_activityActivité principale (sociétés uniquement).
nationality_countrynoteNote en texte libre, 4000 caractères au maximum pour une NOUVELLE valeur ; une note stockée plus longue peut être renvoyée telle quelle. null efface la note.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
idId du client. Utilisez-le comme client_id ailleurs.
512name"Kovács Kft."is_personTrue pour une personne physique, false pour une société.
emailphonearchivedrecorded_by_user_idrecorded_bycreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserataddressChamps de address
zipcitystreetmailing_addressChamps de mailing_address
zipcitystreettax_numberSociétés uniquement ; null pour une personne physique.
company_registration_numberSociétés uniquement ; null pour une personne physique.
representative_nameSociétés uniquement ; null pour une personne physique.
representative_positionSociétés uniquement ; null pour une personne physique.
main_activityActivité principale. Sociétés uniquement ; null pour une personne physique.
nationality_countrynoteupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/clients/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/clients/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/clients/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}
Exemples de réponses
{
"data": {
"id": 512,
"name": "Kovács Kft.",
"is_person": true,
"email": "info@example.hu",
"phone": "string",
"archived": true,
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"address": {
"zip": "string",
"city": "string",
"street": "string"
},
"mailing_address": {
"zip": "string",
"city": "string",
"street": "string"
},
"tax_number": "string",
"company_registration_number": "string",
"representative_name": "string",
"representative_position": "string",
"main_activity": "string",
"nationality_country": "string",
"note": "string"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Contacts
Lister les contacts
/api/agent/contacts
Liste les contacts des clients (personnes de contact), par ordre alphabétique de nom. Transmettez client_id pour lister les contacts d'un seul client. q recherche dans le nom, l'e-mail et le téléphone. Pour les contacts rattachés à un dossier, utilisez plutôt matters.contacts.
Paramètres de requête
client_idFiltrer sur les contacts d'un seul client.
512qRechercher dans le nom, l'e-mail et le téléphone.
"Anna"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idId du contact.
734name"Dr. Kovács Anna"organizationOrganisation / company, if recorded.
positionRole or position, if recorded.
"ügyvezető"notedateLegacy free date field. Read-only.
emailsAll e-mail addresses (structured, multi-value).
Champs de emails
emailtypeis_primaryphonesAll phone numbers (structured, multi-value).
Champs de phones
phonetypeis_primaryaddressesAll postal addresses (structured, multi-value).
Champs de addresses
formattedpostal_codecitystreetcountrytypeis_primaryclient_idsIds of the clients this contact is linked to.
matter_idsIds of the matters this contact is linked to.
client_idPrimary/first client id (compat; see client_ids[]).
512emailPrimary e-mail (compat; see emails[]).
phonePrimary phone (compat; see phones[]).
addressPrimary address (compat; see addresses[]).
created_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/contacts?client_id=512&q=Anna&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/contacts?client_id=512&q=Anna&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/contacts?client_id=512&q=Anna&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 734,
"name": "Dr. Kovács Anna",
"organization": "string",
"position": "ügyvezető",
"note": "string",
"date": "string",
"emails": [
{
"email": "info@example.hu",
"type": "string",
"is_primary": true
}
],
"phones": [
{
"phone": "string",
"type": "string",
"is_primary": true
}
],
"addresses": [
{
"formatted": "string",
"postal_code": "string",
"city": "string",
"street": "string",
"country": "string",
"type": "string",
"is_primary": true
}
],
"client_ids": [
0
],
"matter_ids": [
0
],
"client_id": 512,
"email": "info@example.hu",
"phone": "string",
"address": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"contacts:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"contacts:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "contacts:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un contact
/api/agent/contacts/{id}
Returns one contact person with all its recorded fields: name, organization, position, e-mails, phones, addresses and note, plus the clients and matters it is linked to.
Paramètres de chemin
idobligatoireId du contact (issu de contacts.list ou matters.contacts).
734Réponses
200
OK.
dataobligatoireChamps de data
idId du contact.
734name"Dr. Kovács Anna"organizationOrganisation / company, if recorded.
positionRole or position, if recorded.
"ügyvezető"notedateLegacy free date field. Read-only.
emailsAll e-mail addresses (structured, multi-value).
Champs de emails
emailtypeis_primaryphonesAll phone numbers (structured, multi-value).
Champs de phones
phonetypeis_primaryaddressesAll postal addresses (structured, multi-value).
Champs de addresses
formattedpostal_codecitystreetcountrytypeis_primaryclient_idsIds of the clients this contact is linked to.
matter_idsIds of the matters this contact is linked to.
client_idPrimary/first client id (compat; see client_ids[]).
512emailPrimary e-mail (compat; see emails[]).
phonePrimary phone (compat; see phones[]).
addressPrimary address (compat; see addresses[]).
created_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/contacts/734' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/contacts/734", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/contacts/734",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 734,
"name": "Dr. Kovács Anna",
"organization": "string",
"position": "ügyvezető",
"note": "string",
"date": "string",
"emails": [
{
"email": "info@example.hu",
"type": "string",
"is_primary": true
}
],
"phones": [
{
"phone": "string",
"type": "string",
"is_primary": true
}
],
"addresses": [
{
"formatted": "string",
"postal_code": "string",
"city": "string",
"street": "string",
"country": "string",
"type": "string",
"is_primary": true
}
],
"client_ids": [
0
],
"matter_ids": [
0
],
"client_id": 512,
"email": "info@example.hu",
"phone": "string",
"address": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "contact",
"record_id": 734
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer un contact
/api/agent/contacts
Crée une personne de contact. Rattachez-la à un nombre quelconque de clients (client_ids) et de dossiers (matter_ids, chacun visible pour vous), ou à aucun. Accepte plusieurs e-mails/téléphones/adresses (le premier est le principal). name est obligatoire ; les anciens champs uniques client_id/matter_id/email/phone/address fonctionnent toujours.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
nameobligatoireNom de la personne de contact. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Dr. Kovács Anna"organizationOrganisation / société.
positionRôle ou fonction.
"ügyvezető"emailsAdresses e-mail ; la première est la principale. À privilégier par rapport au champ unique email.
[
"anna@kovacskft.hu"
]emailAncien e-mail unique (compatibilité ; privilégiez emails[]).
"anna@kovacskft.hu"phonesNuméros de téléphone ; le premier est le principal. À privilégier par rapport au champ unique phone.
[
"+36 1 234 5678"
]phoneAncien téléphone unique (compatibilité ; privilégiez phones[]).
"+36 1 234 5678"addressesAdresses postales (texte libre) ; la première est la principale. À privilégier par rapport au champ unique address.
addressAncienne adresse unique (compatibilité ; privilégiez addresses[]).
noteclient_idsIdentifiants des clients (mandants) auxquels rattacher le contact. Nombre quelconque, ou aucun. À privilégier par rapport au champ unique client_id.
[
512
]client_idAncien client unique à rattacher (compatibilité ; privilégiez client_ids[]).
512matter_idsIdentifiants des dossiers auxquels rattacher le contact (chacun doit être visible pour vous). Nombre quelconque, ou aucun. À privilégier par rapport au champ unique matter_id.
[
1234
]matter_idAncien dossier unique à rattacher (compatibilité ; privilégiez matter_ids[]).
1234idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idId du contact.
734name"Dr. Kovács Anna"organizationOrganisation / company, if recorded.
positionRole or position, if recorded.
"ügyvezető"notedateLegacy free date field. Read-only.
emailsAll e-mail addresses (structured, multi-value).
Champs de emails
emailtypeis_primaryphonesAll phone numbers (structured, multi-value).
Champs de phones
phonetypeis_primaryaddressesAll postal addresses (structured, multi-value).
Champs de addresses
formattedpostal_codecitystreetcountrytypeis_primaryclient_idsIds of the clients this contact is linked to.
matter_idsIds of the matters this contact is linked to.
client_idPrimary/first client id (compat; see client_ids[]).
512emailPrimary e-mail (compat; see emails[]).
phonePrimary phone (compat; see phones[]).
addressPrimary address (compat; see addresses[]).
created_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idId du contact.
734name"Dr. Kovács Anna"organizationOrganisation / company, if recorded.
positionRole or position, if recorded.
"ügyvezető"notedateLegacy free date field. Read-only.
emailsAll e-mail addresses (structured, multi-value).
Champs de emails
emailtypeis_primaryphonesAll phone numbers (structured, multi-value).
Champs de phones
phonetypeis_primaryaddressesAll postal addresses (structured, multi-value).
Champs de addresses
formattedpostal_codecitystreetcountrytypeis_primaryclient_idsIds of the clients this contact is linked to.
matter_idsIds of the matters this contact is linked to.
client_idPrimary/first client id (compat; see client_ids[]).
512emailPrimary e-mail (compat; see emails[]).
phonePrimary phone (compat; see phones[]).
addressPrimary address (compat; see addresses[]).
created_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/contacts' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"name": "Dr. Kovács Anna",
"position": "ügyvezető",
"emails": [
"anna@kovacskft.hu"
],
"email": "anna@kovacskft.hu",
"phones": [
"+36 1 234 5678"
],
"phone": "+36 1 234 5678",
"client_ids": [
512
],
"client_id": 512,
"matter_ids": [
1234
],
"matter_id": 1234
}'
const response = await fetch("https://www.flowyer.fr/api/agent/contacts", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"name": "Dr. Kovács Anna",
"position": "ügyvezető",
"emails": [
"anna@kovacskft.hu"
],
"email": "anna@kovacskft.hu",
"phones": [
"+36 1 234 5678"
],
"phone": "+36 1 234 5678",
"client_ids": [
512
],
"client_id": 512,
"matter_ids": [
1234
],
"matter_id": 1234
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/contacts",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"name": "Dr. Kovács Anna",
"position": "ügyvezető",
"emails": [
"anna@kovacskft.hu",
],
"email": "anna@kovacskft.hu",
"phones": [
"+36 1 234 5678",
],
"phone": "+36 1 234 5678",
"client_ids": [
512,
],
"client_id": 512,
"matter_ids": [
1234,
],
"matter_id": 1234,
},
timeout=30,
)
print(response.status_code, response.json())
{
"name": "Dr. Kovács Anna",
"position": "ügyvezető",
"emails": [
"anna@kovacskft.hu"
],
"email": "anna@kovacskft.hu",
"phones": [
"+36 1 234 5678"
],
"phone": "+36 1 234 5678",
"client_ids": [
512
],
"client_id": 512,
"matter_ids": [
1234
],
"matter_id": 1234
}
Exemples de réponses
{
"data": {
"id": 734,
"name": "Dr. Kovács Anna",
"organization": "string",
"position": "ügyvezető",
"note": "string",
"date": "string",
"emails": [
{
"email": "info@example.hu",
"type": "string",
"is_primary": true
}
],
"phones": [
{
"phone": "string",
"type": "string",
"is_primary": true
}
],
"addresses": [
{
"formatted": "string",
"postal_code": "string",
"city": "string",
"street": "string",
"country": "string",
"type": "string",
"is_primary": true
}
],
"client_ids": [
0
],
"matter_ids": [
0
],
"client_id": 512,
"email": "info@example.hu",
"phone": "string",
"address": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 734,
"name": "Dr. Kovács Anna",
"organization": "string",
"position": "ügyvezető",
"note": "string",
"date": "string",
"emails": [
{
"email": "info@example.hu",
"type": "string",
"is_primary": true
}
],
"phones": [
{
"phone": "string",
"type": "string",
"is_primary": true
}
],
"addresses": [
{
"formatted": "string",
"postal_code": "string",
"city": "string",
"street": "string",
"country": "string",
"type": "string",
"is_primary": true
}
],
"client_ids": [
0
],
"matter_ids": [
0
],
"client_id": 512,
"email": "info@example.hu",
"phone": "string",
"address": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"name": [
"Le champ name est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier un contact
/api/agent/contacts/{id}
Modifie un contact : nom, organisation, fonction, note, ainsi que les e-mails, téléphones, adresses, liens avec les clients (client_ids) et liens avec les dossiers (matter_ids), remplacés en totalité. Transmettez expected_updated_at (409 en cas de conflit). La modification de l'e-mail principal d'un contact du portail nécessite une confirmation en deux étapes.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
nameNom de la personne de contact. "<" et ">" ne peuvent pas être introduits ; null conserve le nom actuel.
^[^<>]*$organizationOrganisation / société. null l'efface.
positionRôle ou fonction. null l'efface.
emailsRemplace TOUS les e-mails ; le premier est le principal. À privilégier par rapport à email. Un tableau vide efface tous les e-mails. La modification de l'e-mail principal d'un contact ayant accès au portail client nécessite une confirmation en deux étapes (elle révoque cet accès).
emailE-mail principal (compatibilité ; privilégiez emails[]). Remplace l'ensemble par cette seule valeur ; null efface tous les e-mails. Pour un contact du portail, la modification se fait en deux étapes : le premier appel renvoie confirmation_required avec un confirm_token, rappelez avec le jeton pour poursuivre.
phonesRemplace TOUS les numéros de téléphone ; le premier est le principal. À privilégier par rapport à phone. Un tableau vide efface tous les téléphones.
phoneTéléphone principal (compatibilité ; privilégiez phones[]). null efface tous les téléphones.
addressesRemplace TOUTES les adresses postales (texte libre) ; la première est la principale. À privilégier par rapport à address. Un tableau vide efface toutes les adresses.
addressAdresse (principale) en texte libre (compatibilité ; privilégiez addresses[]). null efface toutes les adresses.
noteNote en texte libre. null l'efface.
client_idsRemplace TOUS les liens avec les clients (mandants). Un tableau vide détache tous les clients. Omettez-le pour ne pas modifier les liens.
matter_idsRemplace TOUS les liens avec les dossiers (chacun doit être visible pour vous). Un tableau vide détache tous les dossiers. Omettez-le pour ne pas les modifier.
confirm_tokenConfirmation en deux étapes pour une modification d'e-mail qui révoquerait l'accès du contact au portail client. Laissez vide lors du premier appel ; rappelez avec les MÊMES arguments et le jeton renvoyé pour poursuivre.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
idId du contact.
734name"Dr. Kovács Anna"organizationOrganisation / company, if recorded.
positionRole or position, if recorded.
"ügyvezető"notedateLegacy free date field. Read-only.
emailsAll e-mail addresses (structured, multi-value).
Champs de emails
emailtypeis_primaryphonesAll phone numbers (structured, multi-value).
Champs de phones
phonetypeis_primaryaddressesAll postal addresses (structured, multi-value).
Champs de addresses
formattedpostal_codecitystreetcountrytypeis_primaryclient_idsIds of the clients this contact is linked to.
matter_idsIds of the matters this contact is linked to.
client_idPrimary/first client id (compat; see client_ids[]).
512emailPrimary e-mail (compat; see emails[]).
phonePrimary phone (compat; see phones[]).
addressPrimary address (compat; see addresses[]).
created_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/contacts/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/contacts/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/contacts/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}
Exemples de réponses
{
"data": {
"id": 734,
"name": "Dr. Kovács Anna",
"organization": "string",
"position": "ügyvezető",
"note": "string",
"date": "string",
"emails": [
{
"email": "info@example.hu",
"type": "string",
"is_primary": true
}
],
"phones": [
{
"phone": "string",
"type": "string",
"is_primary": true
}
],
"addresses": [
{
"formatted": "string",
"postal_code": "string",
"city": "string",
"street": "string",
"country": "string",
"type": "string",
"is_primary": true
}
],
"client_ids": [
0
],
"matter_ids": [
0
],
"client_id": 512,
"email": "info@example.hu",
"phone": "string",
"address": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les contacts d'un dossier
/api/agent/matters/{id}/contacts
Lists the contact persons attached to a matter (via cases_contacts), alphabetically by name. q searches name, e-mail and phone. A contact may be linked to the matter independently of its clients; see contacts.get for one contact.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
qRechercher dans le nom, l'e-mail et le téléphone.
"Anna"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idId du contact.
734name"Dr. Kovács Anna"organizationOrganisation / company, if recorded.
positionRole or position, if recorded.
"ügyvezető"notedateLegacy free date field. Read-only.
emailsAll e-mail addresses (structured, multi-value).
Champs de emails
emailtypeis_primaryphonesAll phone numbers (structured, multi-value).
Champs de phones
phonetypeis_primaryaddressesAll postal addresses (structured, multi-value).
Champs de addresses
formattedpostal_codecitystreetcountrytypeis_primaryclient_idsIds of the clients this contact is linked to.
matter_idsIds of the matters this contact is linked to.
client_idPrimary/first client id (compat; see client_ids[]).
512emailPrimary e-mail (compat; see emails[]).
phonePrimary phone (compat; see phones[]).
addressPrimary address (compat; see addresses[]).
created_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/contacts?q=Anna&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/contacts?q=Anna&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/contacts?q=Anna&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 734,
"name": "Dr. Kovács Anna",
"organization": "string",
"position": "ügyvezető",
"note": "string",
"date": "string",
"emails": [
{
"email": "info@example.hu",
"type": "string",
"is_primary": true
}
],
"phones": [
{
"phone": "string",
"type": "string",
"is_primary": true
}
],
"addresses": [
{
"formatted": "string",
"postal_code": "string",
"city": "string",
"street": "string",
"country": "string",
"type": "string",
"is_primary": true
}
],
"client_ids": [
0
],
"matter_ids": [
0
],
"client_id": 512,
"email": "info@example.hu",
"phone": "string",
"address": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Tâches
Lister les tâches
/api/agent/tasks
Liste les tâches (actions à réaliser avant une échéance) que l'utilisateur peut voir, de l'échéance la plus proche à la plus lointaine. Tâches ouvertes par défaut ; filtrez par responsable, dossier, client ou période d'échéance.
Paramètres de requête
statusopen (par défaut), closed ou all.
"open" "closed" "all" "open"assigned_to_user_idUniquement les tâches attribuées à cet utilisateur (un identifiant d'utilisateur issu de colleagues.list).
matter_idUniquement les tâches de ce dossier.
client_idUniquement les tâches hors dossier de ce client.
deadline_fromÉchéance à cette date ou après.
"2026-11-01"deadline_toÉchéance à cette date ou avant.
"2026-11-30"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id9876subject"Submit the statement of defence"descriptiondeadlineÉchéance, YYYY-MM-DD.
"2026-11-15"priority1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).
2status"open" "closed" closed_atJour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
matterLe dossier auquel la tâche appartient, le cas échéant.
Champs de matter
idcase_numberclientLe client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.
Champs de client
idnameassigned_to_user_idassigned_tocreated_by_user_idcreated_byflag_idcreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/tasks?deadline_from=2026-11-01&deadline_to=2026-11-30&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/tasks?deadline_from=2026-11-01&deadline_to=2026-11-30&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/tasks?deadline_from=2026-11-01&deadline_to=2026-11-30&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 9876,
"subject": "Submit the statement of defence",
"description": "string",
"deadline": "2026-11-15",
"priority": 2,
"status": "open",
"closed_at": "2026-10-30",
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"assigned_to_user_id": 1234,
"assigned_to": "string",
"created_by_user_id": 1234,
"created_by": "string",
"flag_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"tasks:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"tasks:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "tasks:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une tâche
/api/agent/tasks/{id}
Renvoie une tâche. Répond 404 lorsque la tâche n'existe pas ou que l'utilisateur ne peut pas la voir.
Paramètres de chemin
idobligatoireIdentifiant de la tâche.
9876Réponses
200
OK.
dataobligatoireChamps de data
id9876subject"Submit the statement of defence"descriptiondeadlineÉchéance, YYYY-MM-DD.
"2026-11-15"priority1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).
2status"open" "closed" closed_atJour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
matterLe dossier auquel la tâche appartient, le cas échéant.
Champs de matter
idcase_numberclientLe client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.
Champs de client
idnameassigned_to_user_idassigned_tocreated_by_user_idcreated_byflag_idcreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/tasks/9876' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/tasks/9876", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/tasks/9876",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 9876,
"subject": "Submit the statement of defence",
"description": "string",
"deadline": "2026-11-15",
"priority": 2,
"status": "open",
"closed_at": "2026-10-30",
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"assigned_to_user_id": 1234,
"assigned_to": "string",
"created_by_user_id": 1234,
"created_by": "string",
"flag_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"task_id": 9876
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer une tâche
/api/agent/tasks
Crée une tâche (action à réaliser avant une échéance), soit sur un dossier (matter_id, visible et non archivé), soit hors dossier, éventuellement pour un client (client_id). Le responsable est par défaut l'utilisateur de la clé ; il est notifié lorsqu'il s'agit d'une autre personne.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
subjectobligatoireCe qui doit être fait. Texte brut.
"Submit the statement of defence"deadlineobligatoireÉchéance, YYYY-MM-DD.
"2026-11-15"matter_idDossier auquel la tâche appartient. Omettez-le pour une tâche hors dossier.
1234client_idClient d'une tâche hors dossier. Non autorisé avec matter_id (la tâche d'un dossier reprend le client du dossier).
assigned_to_user_idMembre de l'équipe responsable de la tâche : un identifiant d'utilisateur issu de colleagues.list (recherchez-y un nom dicté). Par défaut : l'utilisateur titulaire de la clé.
priority1 = basse, 2 = moyenne (par défaut), 3 = haute.
2descriptionDétails plus longs, texte brut.
flag_idIdentifiant d'un marqueur de tâche du cabinet (étiquette).
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id9876subject"Submit the statement of defence"descriptiondeadlineÉchéance, YYYY-MM-DD.
"2026-11-15"priority1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).
2status"open" "closed" closed_atJour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
matterLe dossier auquel la tâche appartient, le cas échéant.
Champs de matter
idcase_numberclientLe client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.
Champs de client
idnameassigned_to_user_idassigned_tocreated_by_user_idcreated_byflag_idcreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id9876subject"Submit the statement of defence"descriptiondeadlineÉchéance, YYYY-MM-DD.
"2026-11-15"priority1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).
2status"open" "closed" closed_atJour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
matterLe dossier auquel la tâche appartient, le cas échéant.
Champs de matter
idcase_numberclientLe client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.
Champs de client
idnameassigned_to_user_idassigned_tocreated_by_user_idcreated_byflag_idcreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/tasks' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"subject": "Submit the statement of defence",
"deadline": "2026-11-15",
"matter_id": 1234
}'
const response = await fetch("https://www.flowyer.fr/api/agent/tasks", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"subject": "Submit the statement of defence",
"deadline": "2026-11-15",
"matter_id": 1234
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/tasks",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"subject": "Submit the statement of defence",
"deadline": "2026-11-15",
"matter_id": 1234,
},
timeout=30,
)
print(response.status_code, response.json())
{
"subject": "Submit the statement of defence",
"deadline": "2026-11-15",
"matter_id": 1234
}
Exemples de réponses
{
"data": {
"id": 9876,
"subject": "Submit the statement of defence",
"description": "string",
"deadline": "2026-11-15",
"priority": 2,
"status": "open",
"closed_at": "2026-10-30",
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"assigned_to_user_id": 1234,
"assigned_to": "string",
"created_by_user_id": 1234,
"created_by": "string",
"flag_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 9876,
"subject": "Submit the statement of defence",
"description": "string",
"deadline": "2026-11-15",
"priority": 2,
"status": "open",
"closed_at": "2026-10-30",
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"assigned_to_user_id": 1234,
"assigned_to": "string",
"created_by_user_id": 1234,
"created_by": "string",
"flag_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"subject": [
"Le champ subject est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une tâche
/api/agent/tasks/{id}
Modifie une tâche : objet, échéance, description, priorité, marqueur, responsable ou dossier de rattachement. Son déplacement vers un dossier recalcule le lien avec la juridiction et supprime le client direct ; client_id ne concerne qu'une tâche hors dossier. Transmettez expected_updated_at ; une modification concurrente renvoie 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
subjectCe qui doit être fait. Texte brut, 1000 caractères au plus pour une NOUVELLE valeur ; un objet enregistré plus long peut être renvoyé tel quel. null conserve l'objet actuel.
deadlineÉchéance, YYYY-MM-DD. null conserve l'échéance actuelle (une échéance ne peut pas être effacée).
matter_idDéplacer la tâche vers ce dossier (il doit être visible et non archivé), ou null pour la détacher. Envoyer le dossier actuel de la tâche ne modifie rien.
client_idClient d'une tâche hors dossier. Autorisé uniquement lorsque la tâche n'a pas de dossier.
assigned_to_user_idNouveau responsable : l'identifiant d'utilisateur d'un membre actif de l'équipe, issu de colleagues.list. Il est notifié s'il ne s'agit pas de vous. Envoyer la valeur actuelle - ou null / 0, valeur relue pour une tâche sans responsable - ne modifie rien.
priority1 = basse, 2 = moyenne, 3 = haute. Omettez-le pour conserver la priorité actuelle (y compris lorsque la tâche est relue avec priority null) ; null est refusé.
descriptionDétails plus longs, texte brut, 10000 caractères au plus pour une NOUVELLE valeur ; une description enregistrée plus longue peut être renvoyée telle quelle.
flag_idIdentifiant d'un marqueur de tâche du cabinet (étiquette), ou null pour le retirer.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
id9876subject"Submit the statement of defence"descriptiondeadlineÉchéance, YYYY-MM-DD.
"2026-11-15"priority1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).
2status"open" "closed" closed_atJour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
matterLe dossier auquel la tâche appartient, le cas échéant.
Champs de matter
idcase_numberclientLe client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.
Champs de client
idnameassigned_to_user_idassigned_tocreated_by_user_idcreated_byflag_idcreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/tasks/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/tasks/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/tasks/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"subject": "string"
}
Exemples de réponses
{
"data": {
"id": 9876,
"subject": "Submit the statement of defence",
"description": "string",
"deadline": "2026-11-15",
"priority": 2,
"status": "open",
"closed_at": "2026-10-30",
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"assigned_to_user_id": 1234,
"assigned_to": "string",
"created_by_user_id": 1234,
"created_by": "string",
"flag_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Clôturer une tâche
/api/agent/tasks/{id}/close
Clôture une tâche. Si des minutes sont indiquées, enregistre également une saisie de temps (nécessite workhours:create et un dossier : celui de la tâche, ou matter_id pour une tâche hors dossier) ; les minutes facturables sont plafonnées au plafond horaire du cabinet. Une seconde clôture renvoie 409, de sorte qu'une nouvelle tentative n'enregistre jamais une seconde saisie.
Paramètres de chemin
idobligatoireIdentifiant de la tâche.
9876Corps de la requête application/json
minutes_spentTemps passé, en minutes. Toute saisie de temps nécessite l'étendue workhours:create et un dossier.
minutes_invoiceableMinutes facturables ; plafonnées au plafond horaire du cabinet.
minutes_normativeMinutes normatives ; enregistrées telles quelles, jamais plafonnées.
matter_idRattacher ce dossier à une tâche HORS DOSSIER lors de la clôture (et permettre ainsi de saisir du temps). Non autorisé lorsque la tâche a déjà un dossier.
client_idClient direct (Megbízó) pour une tâche hors dossier clôturée sans dossier.
Réponses
200
OK.
dataobligatoireChamps de data
id9876subject"Submit the statement of defence"descriptiondeadlineÉchéance, YYYY-MM-DD.
"2026-11-15"priority1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).
2status"open" "closed" closed_atJour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.
matterLe dossier auquel la tâche appartient, le cas échéant.
Champs de matter
idcase_numberclientLe client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.
Champs de client
idnameassigned_to_user_idassigned_tocreated_by_user_idcreated_byflag_idcreated_atupdated_atcreated_via_apiChamps de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratbooked_workhourLa saisie de temps enregistrée lors de la clôture, ou null si aucun temps n'a été indiqué.
Champs de booked_workhour
idminutesminutes_invoiceableminutes_normative
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/tasks/9876/close' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{}'
const response = await fetch("https://www.flowyer.fr/api/agent/tasks/9876/close", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const result = await response.json();
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/tasks/9876/close",
headers={
"Authorization": "Bearer flw_...",
},
json={},
timeout=30,
)
print(response.status_code, response.json())
{}
Exemples de réponses
{
"data": {
"id": 9876,
"subject": "Submit the statement of defence",
"description": "string",
"deadline": "2026-11-15",
"priority": 2,
"status": "open",
"closed_at": "2026-10-30",
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"assigned_to_user_id": 1234,
"assigned_to": "string",
"created_by_user_id": 1234,
"created_by": "string",
"flag_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"booked_workhour": {
"id": 1234,
"minutes": 0,
"minutes_invoiceable": 0,
"minutes_normative": 0
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Temps passés
Lister les saisies de temps
/api/agent/workhours
Liste les saisies de temps des dossiers que l'utilisateur peut voir, des plus récentes aux plus anciennes. Par défaut, uniquement les saisies actives (pas encore facturées) ; transmettez status=invoiced pour les saisies facturées (lecture seule, id null) ou all pour les deux. Filtrez par dossier, membre de l'équipe responsable ou période. Les saisies excluded: true ne comptent pas dans les totaux facturables.
Paramètres de requête
matter_idUniquement les saisies de ce dossier.
1234responsible_user_idUniquement les saisies imputées à ce membre de l'équipe (un identifiant d'utilisateur issu de colleagues.list).
date_fromUniquement les saisies à cette date ou après (YYYY-MM-DD).
date_toUniquement les saisies à cette date ou avant (YYYY-MM-DD).
external_idUniquement la saisie portant cet identifiant externe (par exemple un identifiant de saisie de temps Clockify). C'est ainsi que vous retrouvez la saisie Flowyer à resynchroniser : filtrez sur cette valeur (utilisez status=all si la saisie peut déjà être facturée), puis mettez à jour le résultat par son id.
statusSaisies à lister : "live" (par défaut, pas encore facturées), "invoiced" (facturées, lecture seule, issues de l'archive - id vaut null et invoiced vaut true) ou "all".
"live" "invoiced" "all" "live"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).
matter_idDossier sur lequel la saisie est imputée.
dateactivityCe qui a été fait (texte brut).
minutesMinutes passées.
minutes_invoiceableMinutes facturables après application du plafond horaire du cabinet (peuvent être inférieures à la demande). Elles ne comptent dans la facturation que tant que excluded vaut false.
minutes_normativeMinutes normatives (à titre indicatif ; jamais plafonnées).
responsible_user_idMembre de l'équipe auquel le temps est imputé.
responsiblerecorded_by_user_idAuteur de l'enregistrement de la saisie.
lockedTrue lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).
excludedTrue lorsqu'un membre de l'équipe a exclu la saisie du relevé de diligences du dossier : elle n'est pas facturée et ses minutes ne comptent pas dans les totaux facturables.
external_idUn identifiant externe stable défini une seule fois à la création (par exemple un identifiant de saisie de temps Clockify), ou null pour une saisie enregistrée dans Flowyer. Pour resynchroniser une saisie source modifiée, retrouvez la saisie Flowyer en filtrant workhours.list sur cette valeur, puis mettez-la à jour par son id.
invoicedTrue lorsque la saisie a été facturée : elle est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation de la saisie (uniquement pour une saisie facturée).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/workhours?matter_id=1234&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/workhours?matter_id=1234&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/workhours?matter_id=1234&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"minutes": 0,
"minutes_invoiceable": 0,
"minutes_normative": 0,
"responsible_user_id": 1234,
"responsible": "string",
"recorded_by_user_id": 1234,
"locked": true,
"excluded": true,
"external_id": "string",
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"workhours:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"workhours:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "workhours:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une saisie de temps
/api/agent/workhours/{id}
Renvoie une saisie de temps active par son identifiant, si son dossier est visible pour l'utilisateur.
Paramètres de chemin
idobligatoireIdentifiant de la saisie de temps.
Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).
matter_idDossier sur lequel la saisie est imputée.
dateactivityCe qui a été fait (texte brut).
minutesMinutes passées.
minutes_invoiceableMinutes facturables après application du plafond horaire du cabinet (peuvent être inférieures à la demande). Elles ne comptent dans la facturation que tant que excluded vaut false.
minutes_normativeMinutes normatives (à titre indicatif ; jamais plafonnées).
responsible_user_idMembre de l'équipe auquel le temps est imputé.
responsiblerecorded_by_user_idAuteur de l'enregistrement de la saisie.
lockedTrue lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).
excludedTrue lorsqu'un membre de l'équipe a exclu la saisie du relevé de diligences du dossier : elle n'est pas facturée et ses minutes ne comptent pas dans les totaux facturables.
external_idUn identifiant externe stable défini une seule fois à la création (par exemple un identifiant de saisie de temps Clockify), ou null pour une saisie enregistrée dans Flowyer. Pour resynchroniser une saisie source modifiée, retrouvez la saisie Flowyer en filtrant workhours.list sur cette valeur, puis mettez-la à jour par son id.
invoicedTrue lorsque la saisie a été facturée : elle est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation de la saisie (uniquement pour une saisie facturée).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/workhours/1234' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/workhours/1234", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/workhours/1234",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"minutes": 0,
"minutes_invoiceable": 0,
"minutes_normative": 0,
"responsible_user_id": 1234,
"responsible": "string",
"recorded_by_user_id": 1234,
"locked": true,
"excluded": true,
"external_id": "string",
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "workhour",
"record_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Enregistrer une saisie de temps
/api/agent/workhours
Enregistre une saisie de temps sur un dossier : date, activité, minutes passées et minutes facturables. Si les minutes facturables sont omises, la saisie n'est pas facturable : envoyez minutes_invoiceable pour un travail facturable. Elles sont plafonnées au plafond horaire du cabinet. Le membre de l'équipe responsable est par défaut l'utilisateur de la clé ; dans le cas contraire, il est notifié.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
matter_idobligatoireDossier sur lequel le temps est imputé (il doit être visible).
1234dateobligatoireDate du travail, YYYY-MM-DD.
"2026-10-30"subjectCe qui a été fait ; la lecture le renvoie sous le nom activity et l'un ou l'autre nom est accepté ici (l'un des deux est obligatoire). Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Drafting the statement of claim"activityLe même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux.
^[^<>]*$minutesMinutes réellement passées.
90minutes_invoiceableMinutes facturables demandées. Omises ou null = non facturable (la saisie ne facture rien ; elles ne sont pas déduites de minutes) : pour un travail facturable, envoyez-les explicitement, généralement égales à minutes. Le plafond horaire du cabinet peut réduire la valeur enregistrée. Elles ne comptent dans la facturation que tant que la saisie n'est pas exclue du relevé de diligences.
60minutes_normativeMinutes normatives (à titre indicatif ; jamais plafonnées).
responsible_user_idMembre de l'équipe auquel le temps est imputé : un identifiant d'utilisateur issu de colleagues.list (recherchez-y un nom dicté). Par défaut : l'utilisateur titulaire de la clé.
external_idUn identifiant externe stable issu du système à partir duquel vous synchronisez (par exemple un identifiant de saisie de temps Clockify). Enregistrez-le pour qu'une modification ultérieure dans ce système soit resynchronisée sur cette seule saisie : renvoyer le même external_id est refusé avec 409 (aucun doublon n'est créé), et la lecture le renvoie. Lettres, chiffres et _.:- uniquement, 64 caractères au plus. Omettez-le pour une saisie ordinaire.
^[A-Za-z0-9_.:-]{1,64}$"65a1f3c9e4b0a2d1f8c7b6a5"idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idIdentifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).
matter_idDossier sur lequel la saisie est imputée.
dateactivityCe qui a été fait (texte brut).
minutesMinutes passées.
minutes_invoiceableMinutes facturables après application du plafond horaire du cabinet (peuvent être inférieures à la demande). Elles ne comptent dans la facturation que tant que excluded vaut false.
minutes_normativeMinutes normatives (à titre indicatif ; jamais plafonnées).
responsible_user_idMembre de l'équipe auquel le temps est imputé.
responsiblerecorded_by_user_idAuteur de l'enregistrement de la saisie.
lockedTrue lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).
excludedTrue lorsqu'un membre de l'équipe a exclu la saisie du relevé de diligences du dossier : elle n'est pas facturée et ses minutes ne comptent pas dans les totaux facturables.
external_idUn identifiant externe stable défini une seule fois à la création (par exemple un identifiant de saisie de temps Clockify), ou null pour une saisie enregistrée dans Flowyer. Pour resynchroniser une saisie source modifiée, retrouvez la saisie Flowyer en filtrant workhours.list sur cette valeur, puis mettez-la à jour par son id.
invoicedTrue lorsque la saisie a été facturée : elle est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation de la saisie (uniquement pour une saisie facturée).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.
createdtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idIdentifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).
matter_idDossier sur lequel la saisie est imputée.
dateactivityCe qui a été fait (texte brut).
minutesMinutes passées.
minutes_invoiceableMinutes facturables après application du plafond horaire du cabinet (peuvent être inférieures à la demande). Elles ne comptent dans la facturation que tant que excluded vaut false.
minutes_normativeMinutes normatives (à titre indicatif ; jamais plafonnées).
responsible_user_idMembre de l'équipe auquel le temps est imputé.
responsiblerecorded_by_user_idAuteur de l'enregistrement de la saisie.
lockedTrue lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).
excludedTrue lorsqu'un membre de l'équipe a exclu la saisie du relevé de diligences du dossier : elle n'est pas facturée et ses minutes ne comptent pas dans les totaux facturables.
external_idUn identifiant externe stable défini une seule fois à la création (par exemple un identifiant de saisie de temps Clockify), ou null pour une saisie enregistrée dans Flowyer. Pour resynchroniser une saisie source modifiée, retrouvez la saisie Flowyer en filtrant workhours.list sur cette valeur, puis mettez-la à jour par son id.
invoicedTrue lorsque la saisie a été facturée : elle est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation de la saisie (uniquement pour une saisie facturée).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.
createdfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
Une saisie de temps avec le même external_id existe déjà (record_conflict) : details.reason vaut external_id_exists et details.record_id est l'id de la saisie existante ; mettez donc à jour cette saisie au lieu de la recréer ; ou external_id_invoiced lorsque la saisie correspondante a été facturée et est en lecture seule. L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused), ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress).
record_conflict) : details.reason vaut external_id_exists et details.record_id est l'id de la saisie existante ; mettez donc à jour cette saisie au lieu de la recréer ; ou external_id_invoiced lorsque la saisie correspondante a été facturée et est en lecture seule. L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused), ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/workhours' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Drafting the statement of claim",
"minutes": 90,
"minutes_invoiceable": 60,
"external_id": "65a1f3c9e4b0a2d1f8c7b6a5"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/workhours", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Drafting the statement of claim",
"minutes": 90,
"minutes_invoiceable": 60,
"external_id": "65a1f3c9e4b0a2d1f8c7b6a5"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/workhours",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Drafting the statement of claim",
"minutes": 90,
"minutes_invoiceable": 60,
"external_id": "65a1f3c9e4b0a2d1f8c7b6a5",
},
timeout=30,
)
print(response.status_code, response.json())
{
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Drafting the statement of claim",
"minutes": 90,
"minutes_invoiceable": 60,
"external_id": "65a1f3c9e4b0a2d1f8c7b6a5"
}
Exemples de réponses
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"minutes": 0,
"minutes_invoiceable": 0,
"minutes_normative": 0,
"responsible_user_id": 1234,
"responsible": "string",
"recorded_by_user_id": 1234,
"locked": true,
"excluded": true,
"external_id": "string",
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": true
}
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"minutes": 0,
"minutes_invoiceable": 0,
"minutes_normative": 0,
"responsible_user_id": 1234,
"responsible": "string",
"recorded_by_user_id": 1234,
"locked": true,
"excluded": true,
"external_id": "string",
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"matter_id": [
"Le champ matter id est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une saisie de temps
/api/agent/workhours/{id}
Modifie une saisie de temps active : date, activité (subject ou activity), minutes, minutes facturables (une valeur modifiée est plafonnée au plafond horaire, une valeur renvoyée à l'identique est conservée) et membre de l'équipe responsable. Une saisie verrouillée ou facturée ne peut pas être modifiée (409). Transmettez expected_updated_at ; un conflit renvoie 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
dateDate du travail, YYYY-MM-DD. null conserve la date actuelle.
subjectCe qui a été fait, la valeur que la lecture renvoie sous le nom activity (l'un ou l'autre nom est accepté ; null sous l'un d'eux signifie "non fourni", seuls deux textes différents sont refusés). Texte brut, 1000 caractères au plus pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas non plus être introduits, mais un texte enregistré plus long ou qui les contient peut être renvoyé tel quel. null conserve le texte actuel.
activityLe même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux (null sous l'autre est accepté).
minutesMinutes réellement passées ; null les efface.
minutes_invoiceableMinutes facturables demandées. Une valeur différente de la valeur enregistrée est plafonnée au solde restant du plafond horaire ; renvoyer la valeur obtenue à la lecture la conserve telle qu'enregistrée (elle n'est pas plafonnée de nouveau). null les efface. Elles ne comptent dans la facturation que tant que la saisie n'est pas exclue du relevé de diligences (excluded vaut false).
minutes_normativeMinutes normatives (jamais plafonnées) ; null les efface.
responsible_user_idNouveau membre de l'équipe responsable : l'identifiant d'utilisateur d'un membre actif de l'équipe, issu de colleagues.list ; il est notifié s'il ne s'agit pas de vous. Envoyer la valeur actuelle - ou null / 0, valeur relue pour une saisie sans responsable - ne modifie rien.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
idIdentifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).
matter_idDossier sur lequel la saisie est imputée.
dateactivityCe qui a été fait (texte brut).
minutesMinutes passées.
minutes_invoiceableMinutes facturables après application du plafond horaire du cabinet (peuvent être inférieures à la demande). Elles ne comptent dans la facturation que tant que excluded vaut false.
minutes_normativeMinutes normatives (à titre indicatif ; jamais plafonnées).
responsible_user_idMembre de l'équipe auquel le temps est imputé.
responsiblerecorded_by_user_idAuteur de l'enregistrement de la saisie.
lockedTrue lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).
excludedTrue lorsqu'un membre de l'équipe a exclu la saisie du relevé de diligences du dossier : elle n'est pas facturée et ses minutes ne comptent pas dans les totaux facturables.
external_idUn identifiant externe stable défini une seule fois à la création (par exemple un identifiant de saisie de temps Clockify), ou null pour une saisie enregistrée dans Flowyer. Pour resynchroniser une saisie source modifiée, retrouvez la saisie Flowyer en filtrant workhours.list sur cette valeur, puis mettez-la à jour par son id.
invoicedTrue lorsque la saisie a été facturée : elle est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation de la saisie (uniquement pour une saisie facturée).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.
updatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at), ou il a été facturé / verrouillé et ne peut plus être modifié via l'API (record_locked ; effectuez la modification dans Flowyer).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at), ou il a été facturé / verrouillé et ne peut plus être modifié via l'API (record_locked ; effectuez la modification dans Flowyer).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/workhours/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/workhours/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/workhours/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30"
}
Exemples de réponses
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"minutes": 0,
"minutes_invoiceable": 0,
"minutes_normative": 0,
"responsible_user_id": 1234,
"responsible": "string",
"recorded_by_user_id": 1234,
"locked": true,
"excluded": true,
"external_id": "string",
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Frais
Lister les frais
/api/agent/costs
Liste les frais des dossiers que l'utilisateur peut voir, des plus récents aux plus anciens. Par défaut, uniquement les frais actifs (pas encore facturés) ; transmettez status=invoiced pour les frais facturés (lecture seule, id null, invoice_id renseigné) ou all pour les deux. Filtrez par dossier, membre de l'équipe responsable ou période. Montants HT ; excluded: true est exclu du relevé de diligences.
Paramètres de requête
matter_idUniquement les frais de ce dossier.
1234responsible_user_idUniquement les frais enregistrés pour ce membre de l'équipe (un id utilisateur issu de colleagues.list).
date_fromUniquement les frais datés de ce jour ou après (YYYY-MM-DD).
date_toUniquement les frais datés de ce jour ou avant (YYYY-MM-DD).
statusFrais à lister : "live" (par défaut, pas encore facturés), "invoiced" (facturés, lecture seule, issus de l'archive - id vaut null et invoiced vaut true) ou "all".
"live" "invoiced" "all" "live"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).
matter_idDossier auquel appartiennent les frais.
dateactivityDescription des frais (texte brut).
costMontant HT des frais (hors TVA).
cost_invoiceableMontant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.
currency_idId de la devise (liste des devises de Flowyer).
currencyCode ISO de la devise, par exemple HUF, EUR.
responsible_user_idresponsibleexcludedTrue lorsqu'un membre de l'équipe a exclu les frais du relevé de diligences du dossier : ils ne sont pas facturés et sont écartés des totaux facturables.
lockedTrue lorsque les frais sont gérés par Flowyer (repris d'une facture entrante, ou majoration de débours) et ne peuvent pas être modifiés via l'API (costs.update répond 409 record_locked, details.reason précise le cas).
approved_for_billingTrue lorsqu'un membre de l'équipe a approuvé les frais pour facturation dans le relevé de diligences du dossier. Ils restent modifiables via l'API (comme sur le web), et l'approbation n'est PAS redemandée ensuite : signalez-le avant de modifier le montant de frais approuvés.
invoicedTrue lorsque le frais a été facturé : il est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation du frais (uniquement pour un frais facturé).
invoice_idLa facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/costs?matter_id=1234&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/costs?matter_id=1234&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/costs?matter_id=1234&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"cost": 0,
"cost_invoiceable": 0,
"currency_id": 1234,
"currency": "string",
"responsible_user_id": 1234,
"responsible": "string",
"excluded": true,
"locked": true,
"approved_for_billing": true,
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"invoice_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"costs:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"costs:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "costs:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une ligne de frais
/api/agent/costs/{id}
Renvoie une ligne de frais en cours par son id, si son dossier est visible pour l'utilisateur. Les montants sont HT.
Paramètres de chemin
idobligatoireId de la ligne de frais.
Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).
matter_idDossier auquel appartiennent les frais.
dateactivityDescription des frais (texte brut).
costMontant HT des frais (hors TVA).
cost_invoiceableMontant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.
currency_idId de la devise (liste des devises de Flowyer).
currencyCode ISO de la devise, par exemple HUF, EUR.
responsible_user_idresponsibleexcludedTrue lorsqu'un membre de l'équipe a exclu les frais du relevé de diligences du dossier : ils ne sont pas facturés et sont écartés des totaux facturables.
lockedTrue lorsque les frais sont gérés par Flowyer (repris d'une facture entrante, ou majoration de débours) et ne peuvent pas être modifiés via l'API (costs.update répond 409 record_locked, details.reason précise le cas).
approved_for_billingTrue lorsqu'un membre de l'équipe a approuvé les frais pour facturation dans le relevé de diligences du dossier. Ils restent modifiables via l'API (comme sur le web), et l'approbation n'est PAS redemandée ensuite : signalez-le avant de modifier le montant de frais approuvés.
invoicedTrue lorsque le frais a été facturé : il est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation du frais (uniquement pour un frais facturé).
invoice_idLa facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/costs/1234' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/costs/1234", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/costs/1234",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"cost": 0,
"cost_invoiceable": 0,
"currency_id": 1234,
"currency": "string",
"responsible_user_id": 1234,
"responsible": "string",
"excluded": true,
"locked": true,
"approved_for_billing": true,
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"invoice_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "cost",
"record_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Enregistrer des frais
/api/agent/costs
Enregistre des frais (débours) sur un dossier : date, texte (subject, relu sous le nom activity), montant HT, montant HT facturé au client et devise (par défaut : la devise du cabinet). Les montants sont HT (hors TVA). Le membre de l'équipe responsable est par défaut l'utilisateur de la clé ; dans le cas contraire, il est notifié.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
matter_idobligatoireDossier auquel appartiennent les frais (doit être visible).
1234dateobligatoireDate des frais, YYYY-MM-DD.
"2026-10-30"subjectDescription des frais ; la lecture la renvoie sous le nom activity et les deux noms sont acceptés ici (l'un des deux est obligatoire). Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Court filing fee"activityLe même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux.
^[^<>]*$costobligatoireMontant HT des frais (hors TVA), nombre entier dans l'unité principale de la devise (les centimes ne sont pas stockés).
15000cost_invoiceableMontant HT à refacturer au client, nombre entier (omettez-le s'il n'est pas facturé). Il n'est pris en compte dans la facturation que tant que les frais ne sont pas exclus du relevé de diligences.
15000currency_idId de devise issu de la liste des devises de Flowyer (pas un code ISO). Omettez-le pour utiliser la devise du cabinet (GET /me office.currency_id / office.currency) ; un id inconnu répond 422 avec les id et codes acceptés dans details.allowed.
responsible_user_idMembre de l'équipe responsable : un id utilisateur issu de colleagues.list (recherchez-y un nom dicté). Par défaut : l'utilisateur de la clé.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idIdentifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).
matter_idDossier auquel appartiennent les frais.
dateactivityDescription des frais (texte brut).
costMontant HT des frais (hors TVA).
cost_invoiceableMontant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.
currency_idId de la devise (liste des devises de Flowyer).
currencyCode ISO de la devise, par exemple HUF, EUR.
responsible_user_idresponsibleexcludedTrue lorsqu'un membre de l'équipe a exclu les frais du relevé de diligences du dossier : ils ne sont pas facturés et sont écartés des totaux facturables.
lockedTrue lorsque les frais sont gérés par Flowyer (repris d'une facture entrante, ou majoration de débours) et ne peuvent pas être modifiés via l'API (costs.update répond 409 record_locked, details.reason précise le cas).
approved_for_billingTrue lorsqu'un membre de l'équipe a approuvé les frais pour facturation dans le relevé de diligences du dossier. Ils restent modifiables via l'API (comme sur le web), et l'approbation n'est PAS redemandée ensuite : signalez-le avant de modifier le montant de frais approuvés.
invoicedTrue lorsque le frais a été facturé : il est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation du frais (uniquement pour un frais facturé).
invoice_idLa facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.
createdtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idIdentifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).
matter_idDossier auquel appartiennent les frais.
dateactivityDescription des frais (texte brut).
costMontant HT des frais (hors TVA).
cost_invoiceableMontant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.
currency_idId de la devise (liste des devises de Flowyer).
currencyCode ISO de la devise, par exemple HUF, EUR.
responsible_user_idresponsibleexcludedTrue lorsqu'un membre de l'équipe a exclu les frais du relevé de diligences du dossier : ils ne sont pas facturés et sont écartés des totaux facturables.
lockedTrue lorsque les frais sont gérés par Flowyer (repris d'une facture entrante, ou majoration de débours) et ne peuvent pas être modifiés via l'API (costs.update répond 409 record_locked, details.reason précise le cas).
approved_for_billingTrue lorsqu'un membre de l'équipe a approuvé les frais pour facturation dans le relevé de diligences du dossier. Ils restent modifiables via l'API (comme sur le web), et l'approbation n'est PAS redemandée ensuite : signalez-le avant de modifier le montant de frais approuvés.
invoicedTrue lorsque le frais a été facturé : il est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation du frais (uniquement pour un frais facturé).
invoice_idLa facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.
createdfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/costs' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Court filing fee",
"cost": 15000,
"cost_invoiceable": 15000
}'
const response = await fetch("https://www.flowyer.fr/api/agent/costs", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Court filing fee",
"cost": 15000,
"cost_invoiceable": 15000
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/costs",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Court filing fee",
"cost": 15000,
"cost_invoiceable": 15000,
},
timeout=30,
)
print(response.status_code, response.json())
{
"matter_id": 1234,
"date": "2026-10-30",
"subject": "Court filing fee",
"cost": 15000,
"cost_invoiceable": 15000
}
Exemples de réponses
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"cost": 0,
"cost_invoiceable": 0,
"currency_id": 1234,
"currency": "string",
"responsible_user_id": 1234,
"responsible": "string",
"excluded": true,
"locked": true,
"approved_for_billing": true,
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"invoice_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": true
}
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"cost": 0,
"cost_invoiceable": 0,
"currency_id": 1234,
"currency": "string",
"responsible_user_id": 1234,
"responsible": "string",
"excluded": true,
"locked": true,
"approved_for_billing": true,
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"invoice_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"matter_id": [
"Le champ matter id est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une ligne de frais
/api/agent/costs/{id}
Modifie une ligne de frais en cours : texte (subject, relu sous le nom activity), date, montants HT, devise et membre de l'équipe responsable. Des frais marqués locked: true ne peuvent pas être modifiés (409 record_locked, details.reason). Transmettez expected_updated_at ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
dateDate des frais, YYYY-MM-DD. null conserve la date actuelle.
subjectDescription des frais, la valeur que la lecture renvoie sous le nom activity (les deux noms sont acceptés ; null sous l'un d'eux signifie "not given", seuls deux textes différents sont refusés). Texte brut, 1000 caractères au maximum pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas non plus être introduits, mais un texte stocké plus long ou qui en contient peut être renvoyé tel quel. null conserve le texte actuel.
activityLe même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux (null sous l'autre est accepté).
costMontant HT des frais (hors TVA), nombre entier dans l'unité principale de la devise (les centimes ne sont pas stockés). null efface le montant.
cost_invoiceableMontant HT à refacturer au client, nombre entier ; null l'efface. Il n'est pris en compte dans la facturation que tant que les frais ne sont pas exclus du relevé de diligences (excluded vaut false).
currency_idId de devise issu de la liste des devises de Flowyer (pas un code ISO ; la devise du cabinet est GET /me office.currency_id). Un id inconnu répond 422 avec les id et codes acceptés dans details.allowed. null, ou le 0 que renvoie à la lecture des frais anciens sans devise définie, conserve la devise actuelle.
responsible_user_idNouveau membre de l'équipe responsable : l'id utilisateur d'un membre actif de l'équipe issu de colleagues.list. Envoyer le responsable actuel, ou null / 0 (valeur renvoyée à la lecture pour des frais sans responsable), ne change rien.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
idIdentifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).
matter_idDossier auquel appartiennent les frais.
dateactivityDescription des frais (texte brut).
costMontant HT des frais (hors TVA).
cost_invoiceableMontant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.
currency_idId de la devise (liste des devises de Flowyer).
currencyCode ISO de la devise, par exemple HUF, EUR.
responsible_user_idresponsibleexcludedTrue lorsqu'un membre de l'équipe a exclu les frais du relevé de diligences du dossier : ils ne sont pas facturés et sont écartés des totaux facturables.
lockedTrue lorsque les frais sont gérés par Flowyer (repris d'une facture entrante, ou majoration de débours) et ne peuvent pas être modifiés via l'API (costs.update répond 409 record_locked, details.reason précise le cas).
approved_for_billingTrue lorsqu'un membre de l'équipe a approuvé les frais pour facturation dans le relevé de diligences du dossier. Ils restent modifiables via l'API (comme sur le web), et l'approbation n'est PAS redemandée ensuite : signalez-le avant de modifier le montant de frais approuvés.
invoicedTrue lorsque le frais a été facturé : il est en lecture seule, se trouve dans l'archive de facturation et son id vaut null. Renvoyé uniquement lorsque status vaut "invoiced" ou "all".
invoiced_atDate de facturation du frais (uniquement pour un frais facturé).
invoice_idLa facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).
created_atupdated_atRenvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.
updatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at), ou il a été facturé / verrouillé et ne peut plus être modifié via l'API (record_locked ; effectuez la modification dans Flowyer).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at), ou il a été facturé / verrouillé et ne peut plus être modifié via l'API (record_locked ; effectuez la modification dans Flowyer).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/costs/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/costs/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/costs/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-10-30"
}
Exemples de réponses
{
"data": {
"id": 1234,
"matter_id": 1234,
"date": "2026-10-30",
"activity": "string",
"cost": 0,
"cost_invoiceable": 0,
"currency_id": 1234,
"currency": "string",
"responsible_user_id": 1234,
"responsible": "string",
"excluded": true,
"locked": true,
"approved_for_billing": true,
"invoiced": true,
"invoiced_at": "2026-10-30T09:15:00+01:00",
"invoice_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Factures
Lister les factures
/api/agent/invoices
Liste les factures (émises et reçues), de la date d'émission la plus récente à la plus ancienne. direction=outgoing correspond à la liste des factures émises par le cabinet et exclut les factures pro forma (direction=proforma les liste). Lecture seule : les factures ne peuvent être ni créées ni modifiées via l'API. Les factures des dossiers que l'utilisateur ne peut pas voir sont masquées.
Paramètres de requête
directionLes trois listes propres au cabinet : outgoing = factures émises par le cabinet, hors factures pro forma (une ligne ancienne sans type de document compte comme une facture, comme dans le tableau de bord du cabinet) ; proforma = demandes de paiement (díjbekérő) émises par le cabinet ; incoming = factures reçues.
"incoming" "outgoing" "proforma" paid_status"unpaid" "paid" "partially_paid" "cancelled" client_idmatter_idissued_fromDate d'émission à partir de ce jour inclus.
"2026-01-01"issued_toDate d'émission jusqu'à ce jour inclus.
"2026-12-31"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id301invoice_number"FLW-2026-0042"directionoutgoing = émise par le cabinet, incoming = reçue par le cabinet.
"incoming" "outgoing" document_type"proforma" est une demande de paiement, et non une facture émise : ce n'est pas un chiffre d'affaires et elle ne doit pas être comptabilisée avec les factures émises. invoices.list direction=outgoing exclut les factures pro forma, direction=proforma les liste. Null sur une ligne ancienne, qui compte comme une facture.
"invoice" "proforma" "receipt" source"manual" "szamlazz_outgoing" "szamlazz_imported" paid_status"unpaid" "paid" "partially_paid" "cancelled" issued_datedue_datepaid_datecompletion_datenet_amountgross_amountcurrency"HUF"payment_method_idpayment_methodNom localisé du mode de paiement (par exemple virement bancaire) ; en anglais lorsque la langue du cabinet n'en a pas de traduction, null lorsque le mode n'a aucun nom. Identifiez le mode par payment_method_id.
supplierÉmetteur d'une facture reçue.
clientChamps de client
idnamematter_idcreated_atupdated_atpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/invoices?issued_from=2026-01-01&issued_to=2026-12-31&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/invoices?issued_from=2026-01-01&issued_to=2026-12-31&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/invoices?issued_from=2026-01-01&issued_to=2026-12-31&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 301,
"invoice_number": "FLW-2026-0042",
"direction": "incoming",
"document_type": "invoice",
"source": "manual",
"paid_status": "unpaid",
"issued_date": "2026-10-30",
"due_date": "2026-10-30",
"paid_date": "2026-10-30",
"completion_date": "2026-10-30",
"net_amount": 0,
"gross_amount": 0,
"currency": "HUF",
"payment_method_id": 1234,
"payment_method": "string",
"supplier": "string",
"client": {
"id": 1234,
"name": "string"
},
"matter_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"invoices:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"invoices:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "invoices:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une facture
/api/agent/invoices/{id}
Renvoie une facture. Lecture seule. Répond 404 lorsqu'elle n'existe pas ou appartient à un dossier que l'utilisateur ne peut pas voir.
Paramètres de chemin
idobligatoireId de la facture.
301Réponses
200
OK.
dataobligatoireChamps de data
id301invoice_number"FLW-2026-0042"directionoutgoing = émise par le cabinet, incoming = reçue par le cabinet.
"incoming" "outgoing" document_type"proforma" est une demande de paiement, et non une facture émise : ce n'est pas un chiffre d'affaires et elle ne doit pas être comptabilisée avec les factures émises. invoices.list direction=outgoing exclut les factures pro forma, direction=proforma les liste. Null sur une ligne ancienne, qui compte comme une facture.
"invoice" "proforma" "receipt" source"manual" "szamlazz_outgoing" "szamlazz_imported" paid_status"unpaid" "paid" "partially_paid" "cancelled" issued_datedue_datepaid_datecompletion_datenet_amountgross_amountcurrency"HUF"payment_method_idpayment_methodNom localisé du mode de paiement (par exemple virement bancaire) ; en anglais lorsque la langue du cabinet n'en a pas de traduction, null lorsque le mode n'a aucun nom. Identifiez le mode par payment_method_id.
supplierÉmetteur d'une facture reçue.
clientChamps de client
idnamematter_idcreated_atupdated_atnotesreceived_datesent_dateproforma_invoice_id
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/invoices/301' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/invoices/301", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/invoices/301",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 301,
"invoice_number": "FLW-2026-0042",
"direction": "incoming",
"document_type": "invoice",
"source": "manual",
"paid_status": "unpaid",
"issued_date": "2026-10-30",
"due_date": "2026-10-30",
"paid_date": "2026-10-30",
"completion_date": "2026-10-30",
"net_amount": 0,
"gross_amount": 0,
"currency": "HUF",
"payment_method_id": 1234,
"payment_method": "string",
"supplier": "string",
"client": {
"id": 1234,
"name": "string"
},
"matter_id": 1234,
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"notes": "string",
"received_date": "2026-10-30",
"sent_date": "2026-10-30",
"proforma_invoice_id": 1234
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"invoice_id": 301
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Documents
Lister les documents d'un dossier
/api/agent/matters/{id}/documents
Liste les versions actuelles des documents classés dans un dossier : noms, tailles, répertoires et auteurs de l'import. Métadonnées uniquement ; utilisez documents.download (étendue documents:download) pour obtenir un lien signé vers le contenu. Les documents nommés apparaissent en premier, par ordre alphabétique, puis les documents importés sans nom.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
qFiltrer par nom de fichier.
"contract"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idnameNom du fichier tel qu'affiché dans Flowyer : le nom stocké avec le document, ou son nom de stockage lorsqu'il a été importé d'un ancien système sans nom. documents.list est trié par nom stocké : les documents qui en ont un apparaissent d'abord, par ordre alphabétique, puis les documents importés sans nom stocké, du plus ancien au plus récent (dans l'ordre de leur classement dans Flowyer), qui ne sont donc pas triés selon le nom affiché ici. L'ordre est identique sur chaque page, de sorte que limit et offset parcourent la liste sans doublon ni lacune.
"Contract_v2.docx"sizeOctets.
versionNuméro de version actuel du fichier.
folderLe répertoire dans lequel le document est classé, ou null à la racine du dossier. documents.upload.complete répond null lorsque le répertoire choisi lors de documents.upload.init a été supprimé pendant l'import des octets : le document est alors classé à la racine du dossier, où Flowyer l'affiche. Si la racine contient déjà un document de ce nom, l'import est classé sous un nom suffixé ("Contract_2.pdf") au lieu de devenir une nouvelle version de ce document sans rapport ; la réponse 201 renvoie le name stocké.
Champs de folder
idnamepathChemin du répertoire dans le dossier, séparé par "/".
folder_deletedTrue lorsque le document est classé dans un répertoire qui n'existe plus, que la liste de fichiers de Flowyer n'affiche pas (folder vaut alors null, comme pour un document à la racine du dossier). documents.upload.complete ne répond true que si le répertoire a été supprimé pendant l'import des octets ET que le déplacement du fichier stocké vers la racine du dossier a échoué : le document est alors conservé dans le répertoire supprimé, où son contenu reste accessible. False dans tous les autres cas, y compris un classement normal à la racine.
created_by_user_idcreated_bycreated_atupdated_atpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/documents?q=contract&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/documents?q=contract&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/documents?q=contract&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"name": "Contract_v2.docx",
"size": 0,
"version": 0,
"folder": {
"id": 1234,
"name": "string",
"path": "string"
},
"folder_deleted": true,
"created_by_user_id": 1234,
"created_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les répertoires d'un dossier
/api/agent/matters/{id}/folders
Liste tous les répertoires d'un dossier, y compris les vides : id, nom, parent_id et le chemin séparé par "/", triés par chemin. Transmettez un identifiant de répertoire en tant que folder_id à documents.upload.init. Répond 404 lorsque le dossier n'est pas visible pour l'utilisateur.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
qUniquement les répertoires dont le chemin contient ce texte (sans tenir compte de la casse ni des accents), par exemple un nom de répertoire.
"Beadványok"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du répertoire : transmettez-le en tant que folder_id à documents.upload.init.
nameNom du répertoire tel qu'affiché dans Flowyer.
parent_idId du répertoire parent ; null pour un répertoire à la racine du dossier.
pathChemin du répertoire au sein du dossier, séparé par "/", par exemple "/Iratok/Beadványok" (le même chemin que documents.list affiche pour le répertoire d'un fichier).
updated_atTransmettez cette valeur à documents.folders.rename comme expected_updated_at.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/folders?q=Beadv%C3%A1nyok&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/folders?q=Beadv%C3%A1nyok&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/folders?q=Beadv%C3%A1nyok&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"name": "string",
"parent_id": 1234,
"path": "string",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer un répertoire de dossier
/api/agent/matters/{id}/folders
Crée un répertoire dans un dossier, à la racine ou sous parent_id (un répertoire du MÊME dossier). Le nom est du texte brut ("<" et ">" ne sont pas autorisés). Pour y classer un document, transmettez l'identifiant renvoyé en tant que folder_id à documents.upload.init. Répond 404 lorsque le dossier n'est pas visible.
Paramètres de chemin
idobligatoireDossier auquel le répertoire appartient (il doit être visible).
1234Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
nameobligatoireNom du répertoire, 255 caractères au plus. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Beadványok"parent_idIdentifiant du répertoire parent (issu de documents.folders) au sein du MÊME dossier ; omettez-le pour un répertoire à la racine du dossier.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idId du répertoire : transmettez-le comme folder_id à documents.upload.init, ou comme parent_id à documents.folders.create.
nameNom du répertoire tel qu'affiché dans Flowyer.
parent_idId du répertoire parent ; null pour un répertoire à la racine du dossier.
pathChemin du répertoire dans le dossier, séparé par "/", par exemple "/Iratok/Beadványok".
updated_atTransmettez cette valeur à documents.folders.rename comme expected_updated_at.
createdtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idId du répertoire : transmettez-le comme folder_id à documents.upload.init, ou comme parent_id à documents.folders.create.
nameNom du répertoire tel qu'affiché dans Flowyer.
parent_idId du répertoire parent ; null pour un répertoire à la racine du dossier.
pathChemin du répertoire dans le dossier, séparé par "/", par exemple "/Iratok/Beadványok".
updated_atTransmettez cette valeur à documents.folders.rename comme expected_updated_at.
createdfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/folders' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"name": "Beadványok"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/folders", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"name": "Beadványok"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/folders",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"name": "Beadványok",
},
timeout=30,
)
print(response.status_code, response.json())
{
"name": "Beadványok"
}
Exemples de réponses
{
"data": {
"id": 1234,
"name": "string",
"parent_id": 1234,
"path": "string",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": true
}
{
"data": {
"id": 1234,
"name": "string",
"parent_id": 1234,
"path": "string",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"name": [
"Le champ name est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Démarrer l'import d'un document
/api/agent/matters/{id}/documents/uploads
Démarre l'import d'un document : renvoie un upload_url signé et un upload_token. Envoyez-y les octets par PUT, puis appelez documents.upload.complete. Le PUT est une simple requête HTTPS en dehors de cette API et des outils MCP : un assistant sans client HTTP propre doit demander à l'utilisateur d'importer le fichier dans Flowyer.
Paramètres de chemin
idobligatoireDossier auquel le document appartient (il doit être visible).
Corps de la requête application/json
filenameobligatoireNom de fichier avec extension, par exemple "Contract.pdf". Texte brut ; "<" et ">" ne sont pas autorisés. Les types de fichiers exécutables et web sont refusés (422 blocked_file_type).
^[^<>]*$"Contract.pdf"content_typeobligatoireType MIME envoyé lors du PUT, par exemple "application/pdf". Il fait partie de la signature et doit correspondre exactement.
"application/pdf"sizeobligatoireTaille du fichier en octets, 104857600 au plus (la limite d'import) ; une taille supérieure renvoie 413 file_too_large.
248000folder_idRépertoire au sein du dossier : un identifiant de répertoire issu de documents.folders (qui liste aussi les répertoires vides). Omettez-le pour la racine du dossier.
Réponses
200
OK.
dataobligatoireChamps de data
upload_urlURL signée. Envoyez-y les octets du fichier par PUT avec le type de contenu indiqué ET l'en-tête if_generation_match ci-dessous : une simple requête HTTPS émise par votre propre client HTTP (aucun outil d'API ou MCP ne l'envoie).
upload_tokenTransmettez cette valeur à documents.upload.complete une fois le PUT réussi.
content_typeEnvoyez exactement ce Content-Type lors du PUT.
if_generation_matchEnvoyez cette valeur dans l'en-tête "x-goog-if-generation-match" lors du PUT (toujours "0"). L'import devient ainsi à usage unique : le PUT n'est accepté que tant que l'objet n'existe pas encore, de sorte que l'URL signée ne peut pas écraser un document déjà classé.
object_keyNom de stockage interne (pour information).
expires_inSecondes restantes avant l'expiration de l'URL d'import et du jeton.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
413
Le corps de la requête est trop volumineux (request_too_large), ou le fichier dépasse la limite d'import (file_too_large ; details.max indique la limite en octets).
request_too_large), ou le fichier dépasse la limite d'import (file_too_large ; details.max indique la limite en octets).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/documents/uploads' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"filename": "Contract.pdf",
"content_type": "application/pdf",
"size": 248000
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/documents/uploads", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"filename": "Contract.pdf",
"content_type": "application/pdf",
"size": 248000
}),
});
const result = await response.json();
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/documents/uploads",
headers={
"Authorization": "Bearer flw_...",
},
json={
"filename": "Contract.pdf",
"content_type": "application/pdf",
"size": 248000,
},
timeout=30,
)
print(response.status_code, response.json())
{
"filename": "Contract.pdf",
"content_type": "application/pdf",
"size": 248000
}
Exemples de réponses
{
"data": {
"upload_url": "string",
"upload_token": "string",
"content_type": "string",
"if_generation_match": "string",
"object_key": "string",
"expires_in": 0
}
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"filename": [
"Le champ filename est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Terminer l'import d'un document
/api/agent/matters/{id}/documents
Termine l'import d'un document : une fois les octets envoyés par PUT vers upload_url, enregistre le fichier sur le dossier en tant que nouvelle version. Transmettez l'upload_token issu de documents.upload.init. Les métadonnées du fichier proviennent du jeton, et non de cette requête. Si le répertoire a été supprimé entre-temps, le document est classé à la racine.
Paramètres de chemin
idobligatoireDossier auquel le document appartient (le même que lors de l'init).
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
upload_tokenobligatoireLe jeton renvoyé par documents.upload.init.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idnameNom du fichier tel qu'affiché dans Flowyer : le nom stocké avec le document, ou son nom de stockage lorsqu'il a été importé d'un ancien système sans nom. documents.list est trié par nom stocké : les documents qui en ont un apparaissent d'abord, par ordre alphabétique, puis les documents importés sans nom stocké, du plus ancien au plus récent (dans l'ordre de leur classement dans Flowyer), qui ne sont donc pas triés selon le nom affiché ici. L'ordre est identique sur chaque page, de sorte que limit et offset parcourent la liste sans doublon ni lacune.
"Contract_v2.docx"sizeOctets.
versionNuméro de version actuel du fichier.
folderLe répertoire dans lequel le document est classé, ou null à la racine du dossier. documents.upload.complete répond null lorsque le répertoire choisi lors de documents.upload.init a été supprimé pendant l'import des octets : le document est alors classé à la racine du dossier, où Flowyer l'affiche. Si la racine contient déjà un document de ce nom, l'import est classé sous un nom suffixé ("Contract_2.pdf") au lieu de devenir une nouvelle version de ce document sans rapport ; la réponse 201 renvoie le name stocké.
Champs de folder
idnamepathChemin du répertoire dans le dossier, séparé par "/".
folder_deletedTrue lorsque le document est classé dans un répertoire qui n'existe plus, que la liste de fichiers de Flowyer n'affiche pas (folder vaut alors null, comme pour un document à la racine du dossier). documents.upload.complete ne répond true que si le répertoire a été supprimé pendant l'import des octets ET que le déplacement du fichier stocké vers la racine du dossier a échoué : le document est alors conservé dans le répertoire supprimé, où son contenu reste accessible. False dans tous les autres cas, y compris un classement normal à la racine.
created_by_user_idcreated_bycreated_atupdated_atcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé. C'est aussi la réponse lorsque cet upload_token a déjà été finalisé.
dataobligatoireChamps de data
idnameNom du fichier tel qu'affiché dans Flowyer : le nom stocké avec le document, ou son nom de stockage lorsqu'il a été importé d'un ancien système sans nom. documents.list est trié par nom stocké : les documents qui en ont un apparaissent d'abord, par ordre alphabétique, puis les documents importés sans nom stocké, du plus ancien au plus récent (dans l'ordre de leur classement dans Flowyer), qui ne sont donc pas triés selon le nom affiché ici. L'ordre est identique sur chaque page, de sorte que limit et offset parcourent la liste sans doublon ni lacune.
"Contract_v2.docx"sizeOctets.
versionNuméro de version actuel du fichier.
folderLe répertoire dans lequel le document est classé, ou null à la racine du dossier. documents.upload.complete répond null lorsque le répertoire choisi lors de documents.upload.init a été supprimé pendant l'import des octets : le document est alors classé à la racine du dossier, où Flowyer l'affiche. Si la racine contient déjà un document de ce nom, l'import est classé sous un nom suffixé ("Contract_2.pdf") au lieu de devenir une nouvelle version de ce document sans rapport ; la réponse 201 renvoie le name stocké.
Champs de folder
idnamepathChemin du répertoire dans le dossier, séparé par "/".
folder_deletedTrue lorsque le document est classé dans un répertoire qui n'existe plus, que la liste de fichiers de Flowyer n'affiche pas (folder vaut alors null, comme pour un document à la racine du dossier). documents.upload.complete ne répond true que si le répertoire a été supprimé pendant l'import des octets ET que le déplacement du fichier stocké vers la racine du dossier a échoué : le document est alors conservé dans le répertoire supprimé, où son contenu reste accessible. False dans tous les autres cas, y compris un classement normal à la racine.
created_by_user_idcreated_bycreated_atupdated_atcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Point de terminaison inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. upload_not_finished : le fichier n'est pas encore arrivé dans le stockage ; terminez le PUT vers upload_url, puis appelez de nouveau complete. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le créez pas de nouveau.
upload_not_finished : le fichier n'est pas encore arrivé dans le stockage ; terminez le PUT vers upload_url, puis appelez de nouveau complete. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le créez pas de nouveau.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large), ou le fichier dépasse la limite d'import (file_too_large ; details.max indique la limite en octets).
request_too_large), ou le fichier dépasse la limite d'import (file_too_large ; details.max indique la limite en octets).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/documents' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"upload_token": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/documents", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"upload_token": "string"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/documents",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"upload_token": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"upload_token": "string"
}
Exemples de réponses
{
"data": {
"id": 1234,
"name": "Contract_v2.docx",
"size": 0,
"version": 0,
"folder": {
"id": 1234,
"name": "string",
"path": "string"
},
"folder_deleted": true,
"created_by_user_id": 1234,
"created_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": true
}
{
"data": {
"id": 1234,
"name": "Contract_v2.docx",
"size": 0,
"version": 0,
"folder": {
"id": 1234,
"name": "string",
"path": "string"
},
"folder_deleted": true,
"created_by_user_id": 1234,
"created_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"upload_token": [
"Le champ upload token est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Télécharger un document
/api/agent/documents/{id}/download
Renvoie une URL signée de courte durée permettant de télécharger un document par son id, si son dossier est visible. Effectuez un GET sur l'URL pour récupérer les octets ; elle expire au bout de quelques minutes.
Paramètres de chemin
idobligatoireId du document (issu de documents.list).
Réponses
200
OK.
dataobligatoireChamps de data
download_urlURL signée. Effectuez un GET dessus pour télécharger les octets du fichier.
filenameNom du fichier pour le téléchargement.
sizeOctets.
expires_inSecondes restantes avant l'expiration de l'URL.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/documents/1234/download' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/documents/1234/download", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/documents/1234/download",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"download_url": "string",
"filename": "string",
"size": 0,
"expires_in": 0
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "document",
"record_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les versions d'un document
/api/agent/documents/{id}/versions
Liste toutes les versions d'un document (transmettez n'importe quel id de version, par exemple issu de documents.list) : numéro de version, nom, taille, auteur de l'import, date et version actuelle. Chaque version a son propre id ; téléchargez-en une avec documents.download, ou lisez-les toutes comme historique complet des versions.
Paramètres de chemin
idobligatoireId du document : n'importe laquelle de ses versions (issu de documents.list ou documents.versions).
1234Paramètres de requête
limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idId de version : transmettez-le à documents.download (étendue documents:download) pour récupérer les octets de cette version précise.
versionNuméro de version ; le plus élevé correspond à la version actuelle.
is_currentTrue pour la version que Flowyer affiche actuellement, false pour une version antérieure remplacée.
nameNom de fichier stocké avec cette version (son nom de stockage lorsqu'elle a été importée sans nom).
sizeOctets.
uploaded_by_user_iduploaded_byuploaded_atDate de classement de cette version.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/documents/1234/versions?limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/documents/1234/versions?limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/documents/1234/versions?limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"version": 0,
"is_current": true,
"name": "string",
"size": 0,
"uploaded_by_user_id": 1234,
"uploaded_by": "string",
"uploaded_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "document",
"record_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Renommer un document
/api/agent/documents/{id}
Renomme un document (uniquement son nom affiché ; le contenu du fichier reste inchangé). Le nouveau nom doit être unique dans le même répertoire du dossier. Transmettez expected_updated_at issu de votre dernière lecture ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
nameobligatoireNouveau nom de fichier, 255 caractères au maximum extension COMPRISE. L'extension actuelle est conservée si vous n'en indiquez pas, et elle compte dans les 255 (ainsi, pour "Beadvany.pdf", un nom sans extension peut comporter au maximum 251 caractères). Texte brut ; "<" et ">" ne sont pas autorisés : un document dont le nom stocké en contient ne peut donc être renommé que dans Flowyer.
^[^<>]*$"Contract_signed.pdf"Réponses
200
Mis à jour.
dataobligatoireChamps de data
idnameNom du fichier tel qu'affiché dans Flowyer : le nom stocké avec le document, ou son nom de stockage lorsqu'il a été importé d'un ancien système sans nom. documents.list est trié par nom stocké : les documents qui en ont un apparaissent d'abord, par ordre alphabétique, puis les documents importés sans nom stocké, du plus ancien au plus récent (dans l'ordre de leur classement dans Flowyer), qui ne sont donc pas triés selon le nom affiché ici. L'ordre est identique sur chaque page, de sorte que limit et offset parcourent la liste sans doublon ni lacune.
"Contract_v2.docx"sizeOctets.
versionNuméro de version actuel du fichier.
folderLe répertoire dans lequel le document est classé, ou null à la racine du dossier. documents.upload.complete répond null lorsque le répertoire choisi lors de documents.upload.init a été supprimé pendant l'import des octets : le document est alors classé à la racine du dossier, où Flowyer l'affiche. Si la racine contient déjà un document de ce nom, l'import est classé sous un nom suffixé ("Contract_2.pdf") au lieu de devenir une nouvelle version de ce document sans rapport ; la réponse 201 renvoie le name stocké.
Champs de folder
idnamepathChemin du répertoire dans le dossier, séparé par "/".
folder_deletedTrue lorsque le document est classé dans un répertoire qui n'existe plus, que la liste de fichiers de Flowyer n'affiche pas (folder vaut alors null, comme pour un document à la racine du dossier). documents.upload.complete ne répond true que si le répertoire a été supprimé pendant l'import des octets ET que le déplacement du fichier stocké vers la racine du dossier a échoué : le document est alors conservé dans le répertoire supprimé, où son contenu reste accessible. False dans tous les autres cas, y compris un classement normal à la racine.
created_by_user_idcreated_bycreated_atupdated_atupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at), ou un autre document du même répertoire porte déjà ce nom (duplicate_name ; choisissez un autre nom, ne réessayez pas avec le même).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at), ou un autre document du même répertoire porte déjà ce nom (duplicate_name ; choisissez un autre nom, ne réessayez pas avec le même).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/documents/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Contract_signed.pdf"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/documents/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Contract_signed.pdf"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/documents/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Contract_signed.pdf",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Contract_signed.pdf"
}
Exemples de réponses
{
"data": {
"id": 1234,
"name": "Contract_v2.docx",
"size": 0,
"version": 0,
"folder": {
"id": 1234,
"name": "string",
"path": "string"
},
"folder_deleted": true,
"created_by_user_id": 1234,
"created_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Renommer un répertoire du dossier
/api/agent/folders/{id}
Renomme un répertoire (uniquement son nom ; ses fichiers et sous-répertoires restent en place). Le nom est en texte brut ("<" et ">" ne sont pas autorisés). Transmettez expected_updated_at issu de votre dernière lecture (documents.folders l'indique) ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
nameobligatoireNouveau nom du répertoire, 255 caractères au maximum. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Beadványok"Réponses
200
Mis à jour.
dataobligatoireChamps de data
idId du répertoire : transmettez-le comme folder_id à documents.upload.init, ou comme parent_id à documents.folders.create.
nameNom du répertoire tel qu'affiché dans Flowyer.
parent_idId du répertoire parent ; null pour un répertoire à la racine du dossier.
pathChemin du répertoire dans le dossier, séparé par "/", par exemple "/Iratok/Beadványok".
updated_atTransmettez cette valeur à documents.folders.rename comme expected_updated_at.
updatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/folders/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Beadványok"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/folders/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Beadványok"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/folders/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Beadványok",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "Beadványok"
}
Exemples de réponses
{
"data": {
"id": 1234,
"name": "string",
"parent_id": 1234,
"path": "string",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Base de connaissances
Lister les articles de la base de connaissances
/api/agent/knowledge/articles
Liste les articles de la base de connaissances visibles pour l'utilisateur (ceux dont il est l'auteur, les articles globaux et les articles partagés avec le rôle de l'utilisateur). Tous les statuts par défaut ; filtrez par statut, ou transmettez q pour une recherche en texte intégral dans les titres, extraits, contenus et étiquettes.
Paramètres de requête
qTerme de recherche en texte intégral (titres, extraits, contenu et noms d'étiquettes). Les opérateurs booléens sont supprimés.
"felmondási idő"statusUniquement les articles ayant ce statut. Omettez-le pour lister tous les statuts.
"draft" "published" "archived" limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id9876slugSlug d'URL généré par le serveur.
"felmondasi-ido"title"Felmondási idő a munka törvénykönyvében"excerptRésumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.
status"draft" "published" "archived" is_featuredIndique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).
category_idcategory_nameauthor_idId utilisateur de l'auteur ; 0 pour un article global (par défaut).
author_nameeditor_idId utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.
editor_nameviews_countdownloads_countshared_rolesId des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).
tagsNoms des étiquettes de l'article.
published_atDate de première publication de l'article, ou null.
created_atupdated_atpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/knowledge/articles?q=felmond%C3%A1si%20id%C5%91&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/articles?q=felmond%C3%A1si%20id%C5%91&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/knowledge/articles?q=felmond%C3%A1si%20id%C5%91&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 9876,
"slug": "felmondasi-ido",
"title": "Felmondási idő a munka törvénykönyvében",
"excerpt": "string",
"status": "draft",
"is_featured": true,
"category_id": 1234,
"category_name": "string",
"author_id": 1234,
"author_name": "string",
"editor_id": 1234,
"editor_name": "string",
"views_count": 0,
"downloads_count": 0,
"shared_roles": [
0
],
"tags": [
"string"
],
"published_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"knowledge:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"knowledge:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "knowledge:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un article de la base de connaissances
/api/agent/knowledge/articles/{id}
Renvoie un article de la base de connaissances, y compris son contenu complet, ses étiquettes et ses rôles de partage. Répond 404 lorsque l'article n'existe pas ou que l'utilisateur ne peut pas le voir.
Paramètres de chemin
idobligatoireId de l'article.
9876Réponses
200
OK.
dataobligatoireChamps de data
id9876slugSlug d'URL généré par le serveur.
"felmondasi-ido"title"Felmondási idő a munka törvénykönyvében"excerptRésumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.
status"draft" "published" "archived" is_featuredIndique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).
category_idcategory_nameauthor_idId utilisateur de l'auteur ; 0 pour un article global (par défaut).
author_nameeditor_idId utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.
editor_nameviews_countdownloads_countshared_rolesId des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).
tagsNoms des étiquettes de l'article.
published_atDate de première publication de l'article, ou null.
created_atupdated_atcontentLe corps complet de l'article tel qu'enregistré (HTML enrichi).
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/knowledge/articles/9876' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/articles/9876", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/knowledge/articles/9876",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 9876,
"slug": "felmondasi-ido",
"title": "Felmondási idő a munka törvénykönyvében",
"excerpt": "string",
"status": "draft",
"is_featured": true,
"category_id": 1234,
"category_name": "string",
"author_id": 1234,
"author_name": "string",
"editor_id": 1234,
"editor_name": "string",
"views_count": 0,
"downloads_count": 0,
"shared_roles": [
0
],
"tags": [
"string"
],
"published_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"content": "string"
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"article_id": 9876
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer un article de la base de connaissances
/api/agent/knowledge/articles
Crée un article de la base de connaissances dont l'auteur est l'utilisateur de la clé. Le slug est généré à partir du titre. La catégorie doit exister et être active. Partagez-le avec des rôles via shared_roles (sinon seul l'auteur le voit). content et excerpt sont en HTML et nettoyés côté serveur.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
titleobligatoireTitre de l'article. Texte brut.
"Felmondási idő a munka törvénykönyvében"excerptRésumé court (HTML autorisé, nettoyé côté serveur), 200 caractères au maximum.
contentobligatoireLe corps de l'article. HTML enrichi, nettoyé côté serveur selon le profil de la base de connaissances.
category_idobligatoireId d'une catégorie existante et active de la base de connaissances.
12statusobligatoiredraft, published ou archived. published renseigne published_at.
"draft" "published" "archived" tagsNoms des étiquettes ; les nouvelles étiquettes sont créées si nécessaire.
shared_rolesId des rôles avec lesquels partager l'article. Vide signifie que seul l'auteur peut le voir.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id9876slugSlug d'URL généré par le serveur.
"felmondasi-ido"title"Felmondási idő a munka törvénykönyvében"excerptRésumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.
status"draft" "published" "archived" is_featuredIndique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).
category_idcategory_nameauthor_idId utilisateur de l'auteur ; 0 pour un article global (par défaut).
author_nameeditor_idId utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.
editor_nameviews_countdownloads_countshared_rolesId des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).
tagsNoms des étiquettes de l'article.
published_atDate de première publication de l'article, ou null.
created_atupdated_atcontentLe corps complet de l'article tel qu'enregistré (HTML enrichi).
createdtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id9876slugSlug d'URL généré par le serveur.
"felmondasi-ido"title"Felmondási idő a munka törvénykönyvében"excerptRésumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.
status"draft" "published" "archived" is_featuredIndique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).
category_idcategory_nameauthor_idId utilisateur de l'auteur ; 0 pour un article global (par défaut).
author_nameeditor_idId utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.
editor_nameviews_countdownloads_countshared_rolesId des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).
tagsNoms des étiquettes de l'article.
published_atDate de première publication de l'article, ou null.
created_atupdated_atcontentLe corps complet de l'article tel qu'enregistré (HTML enrichi).
createdfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/knowledge/articles' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"title": "Felmondási idő a munka törvénykönyvében",
"content": "string",
"category_id": 12,
"status": "draft"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/articles", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"title": "Felmondási idő a munka törvénykönyvében",
"content": "string",
"category_id": 12,
"status": "draft"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/knowledge/articles",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"title": "Felmondási idő a munka törvénykönyvében",
"content": "string",
"category_id": 12,
"status": "draft",
},
timeout=30,
)
print(response.status_code, response.json())
{
"title": "Felmondási idő a munka törvénykönyvében",
"content": "string",
"category_id": 12,
"status": "draft"
}
Exemples de réponses
{
"data": {
"id": 9876,
"slug": "felmondasi-ido",
"title": "Felmondási idő a munka törvénykönyvében",
"excerpt": "string",
"status": "draft",
"is_featured": true,
"category_id": 1234,
"category_name": "string",
"author_id": 1234,
"author_name": "string",
"editor_id": 1234,
"editor_name": "string",
"views_count": 0,
"downloads_count": 0,
"shared_roles": [
0
],
"tags": [
"string"
],
"published_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"content": "string"
},
"created": true
}
{
"data": {
"id": 9876,
"slug": "felmondasi-ido",
"title": "Felmondási idő a munka törvénykönyvében",
"excerpt": "string",
"status": "draft",
"is_featured": true,
"category_id": 1234,
"category_name": "string",
"author_id": 1234,
"author_name": "string",
"editor_id": 1234,
"editor_name": "string",
"views_count": 0,
"downloads_count": 0,
"shared_roles": [
0
],
"tags": [
"string"
],
"published_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"content": "string"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"title": [
"Le champ title est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier un article de la base de connaissances
/api/agent/knowledge/articles/{id}
Modifie un article de la base de connaissances : titre (le slug est recalculé), extrait, contenu, catégorie, statut, étiquettes ou rôles de partage. Seul l'auteur peut le modifier (ou n'importe qui, pour un article global). Transmettez expected_updated_at ; une modification conflictuelle répond 409. content et excerpt sont nettoyés côté serveur.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
titleTitre de l'article (texte brut). null conserve le titre actuel ; un nouveau titre entraîne le recalcul du slug.
excerptRésumé court (HTML autorisé, nettoyé), 200 caractères au maximum pour une NOUVELLE valeur. Vide/null l'efface ; omettez-le pour le conserver.
contentLe corps de l'article (HTML enrichi, nettoyé). null conserve le contenu actuel ; il ne peut pas être effacé.
category_idDéplace l'article vers cette catégorie existante et active. null conserve la catégorie actuelle.
statusdraft, published ou archived. Le premier passage à published renseigne published_at ; cette valeur n'est jamais effacée. null conserve le statut actuel.
"draft" "published" "archived" tagsRemplace l'ensemble des étiquettes (les nouvelles étiquettes sont créées). Un tableau vide efface toutes les étiquettes ; omettez-le pour les conserver.
shared_rolesRemplace l'ensemble des rôles de partage. Un tableau vide supprime tout partage (seul l'auteur le voit) ; omettez-le pour le conserver.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
id9876slugSlug d'URL généré par le serveur.
"felmondasi-ido"title"Felmondási idő a munka törvénykönyvében"excerptRésumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.
status"draft" "published" "archived" is_featuredIndique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).
category_idcategory_nameauthor_idId utilisateur de l'auteur ; 0 pour un article global (par défaut).
author_nameeditor_idId utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.
editor_nameviews_countdownloads_countshared_rolesId des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).
tagsNoms des étiquettes de l'article.
published_atDate de première publication de l'article, ou null.
created_atupdated_atcontentLe corps complet de l'article tel qu'enregistré (HTML enrichi).
updatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/knowledge/articles/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/articles/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/knowledge/articles/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string"
}
Exemples de réponses
{
"data": {
"id": 9876,
"slug": "felmondasi-ido",
"title": "Felmondási idő a munka törvénykönyvében",
"excerpt": "string",
"status": "draft",
"is_featured": true,
"category_id": 1234,
"category_name": "string",
"author_id": 1234,
"author_name": "string",
"editor_id": 1234,
"editor_name": "string",
"views_count": 0,
"downloads_count": 0,
"shared_roles": [
0
],
"tags": [
"string"
],
"published_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"content": "string"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les catégories de la base de connaissances
/api/agent/knowledge/categories
Liste les catégories de la base de connaissances visibles pour l'utilisateur : les catégories par défaut intégrées, celles de l'utilisateur et celles partagées avec le rôle de l'utilisateur. Dans l'ordre utilisé par Flowyer (position de tri, puis nom).
Paramètres de requête
limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id42slugSlug d'URL, généré à partir du nom.
"munkajog"name"Munkajog"descriptionDescription en texte brut, ou null.
iconIdentifiant de l'icône affichée à côté de la catégorie, ou null.
order_columnPosition de tri parmi les catégories de même niveau.
0is_activeparent_idId de la catégorie parente, ou null pour une catégorie racine.
author_idId utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.
author_nameNom affiché du créateur, ou null pour une catégorie par défaut.
articles_countNombre d'articles publiés de cette catégorie que l'appelant peut voir.
shared_rolesId des rôles avec lesquels cette catégorie est partagée. Vide signifie que seul l'auteur la voit (une catégorie par défaut dont author_id vaut 0 est visible par tous).
created_atupdated_atpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/knowledge/categories?limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/categories?limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/knowledge/categories?limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 42,
"slug": "munkajog",
"name": "Munkajog",
"description": "string",
"icon": "string",
"order_column": 0,
"is_active": true,
"parent_id": 1234,
"author_id": 1234,
"author_name": "string",
"articles_count": 0,
"shared_roles": [
1
],
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"knowledge:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"knowledge:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "knowledge:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une catégorie de la base de connaissances
/api/agent/knowledge/categories/{id}
Renvoie une catégorie de la base de connaissances. Répond 404 lorsque la catégorie n'existe pas ou n'est pas visible pour l'utilisateur titulaire de cette clé API.
Paramètres de chemin
idobligatoireId de la catégorie.
42Réponses
200
OK.
dataobligatoireChamps de data
id42slugSlug d'URL, généré à partir du nom.
"munkajog"name"Munkajog"descriptionDescription en texte brut, ou null.
iconIdentifiant de l'icône affichée à côté de la catégorie, ou null.
order_columnPosition de tri parmi les catégories de même niveau.
0is_activeparent_idId de la catégorie parente, ou null pour une catégorie racine.
author_idId utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.
author_nameNom affiché du créateur, ou null pour une catégorie par défaut.
articles_countNombre d'articles publiés de cette catégorie que l'appelant peut voir.
shared_rolesId des rôles avec lesquels cette catégorie est partagée. Vide signifie que seul l'auteur la voit (une catégorie par défaut dont author_id vaut 0 est visible par tous).
created_atupdated_at
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/knowledge/categories/42' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/categories/42", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/knowledge/categories/42",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 42,
"slug": "munkajog",
"name": "Munkajog",
"description": "string",
"icon": "string",
"order_column": 0,
"is_active": true,
"parent_id": 1234,
"author_id": 1234,
"author_name": "string",
"articles_count": 0,
"shared_roles": [
1
],
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"category_id": 42
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer une catégorie de la base de connaissances
/api/agent/knowledge/categories
Crée une catégorie de la base de connaissances. Le slug d'URL est généré à partir du nom. Partagez-la avec des rôles via shared_roles, ou omettez-les pour que vous seul (l'auteur) puissiez la voir. Un parent_id, s'il est fourni, doit correspondre à une catégorie existante et active.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
nameobligatoireNom de la catégorie. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Munkajog"descriptionDescription facultative, en texte brut.
parent_idId de la catégorie parente (doit exister et être active). Omettez-le pour une catégorie racine.
iconIdentifiant d'icône facultatif. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$is_activeIndique si la catégorie est active. Par défaut true.
trueorder_columnPosition de tri parmi les catégories de même niveau. Par défaut 0.
0shared_rolesId des rôles avec lesquels partager cette catégorie. Omettez-le pour que vous seul (l'auteur) puissiez la voir.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id42slugSlug d'URL, généré à partir du nom.
"munkajog"name"Munkajog"descriptionDescription en texte brut, ou null.
iconIdentifiant de l'icône affichée à côté de la catégorie, ou null.
order_columnPosition de tri parmi les catégories de même niveau.
0is_activeparent_idId de la catégorie parente, ou null pour une catégorie racine.
author_idId utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.
author_nameNom affiché du créateur, ou null pour une catégorie par défaut.
articles_countNombre d'articles publiés de cette catégorie que l'appelant peut voir.
shared_rolesId des rôles avec lesquels cette catégorie est partagée. Vide signifie que seul l'auteur la voit (une catégorie par défaut dont author_id vaut 0 est visible par tous).
created_atupdated_atcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id42slugSlug d'URL, généré à partir du nom.
"munkajog"name"Munkajog"descriptionDescription en texte brut, ou null.
iconIdentifiant de l'icône affichée à côté de la catégorie, ou null.
order_columnPosition de tri parmi les catégories de même niveau.
0is_activeparent_idId de la catégorie parente, ou null pour une catégorie racine.
author_idId utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.
author_nameNom affiché du créateur, ou null pour une catégorie par défaut.
articles_countNombre d'articles publiés de cette catégorie que l'appelant peut voir.
shared_rolesId des rôles avec lesquels cette catégorie est partagée. Vide signifie que seul l'auteur la voit (une catégorie par défaut dont author_id vaut 0 est visible par tous).
created_atupdated_atcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/knowledge/categories' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"name": "Munkajog",
"order_column": 0
}'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/categories", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"name": "Munkajog",
"order_column": 0
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/knowledge/categories",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"name": "Munkajog",
"order_column": 0,
},
timeout=30,
)
print(response.status_code, response.json())
{
"name": "Munkajog",
"order_column": 0
}
Exemples de réponses
{
"data": {
"id": 42,
"slug": "munkajog",
"name": "Munkajog",
"description": "string",
"icon": "string",
"order_column": 0,
"is_active": true,
"parent_id": 1234,
"author_id": 1234,
"author_name": "string",
"articles_count": 0,
"shared_roles": [
1
],
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": true
}
{
"data": {
"id": 42,
"slug": "munkajog",
"name": "Munkajog",
"description": "string",
"icon": "string",
"order_column": 0,
"is_active": true,
"parent_id": 1234,
"author_id": 1234,
"author_name": "string",
"articles_count": 0,
"shared_roles": [
1
],
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"name": [
"Le champ name est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une catégorie de la base de connaissances
/api/agent/knowledge/categories/{id}
Modifie une catégorie de la base de connaissances : nom (le slug suit), description, icône, parent, indicateur d'activité, position de tri ou rôles avec lesquels elle est partagée. Seul l'auteur peut la modifier (une catégorie par défaut intégrée est modifiable par tous). Transmettez expected_updated_at ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
nameNom de la catégorie. 255 caractères au maximum pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas être introduits, mais un nom stocké plus long ou qui en contient peut être renvoyé tel quel. null conserve le nom actuel.
descriptionDescription en texte brut. null l'efface.
parent_idDéplace la catégorie sous ce parent (qui doit exister, être actif et ne pas créer de cycle), ou null pour en faire une catégorie racine.
iconIdentifiant d'icône. 100 caractères au maximum pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas être introduits. null l'efface.
is_activeIndicateur d'activité. Omettez-le ou indiquez null pour conserver la valeur actuelle.
order_columnPosition de tri parmi les catégories de même niveau. Omettez-la ou indiquez null pour conserver la valeur actuelle.
shared_rolesRemplace l'ensemble des id de rôles avec lesquels cette catégorie est partagée. Un tableau vide supprime tout partage (seul l'auteur la voit). Omettez-le pour laisser le partage inchangé.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
id42slugSlug d'URL, généré à partir du nom.
"munkajog"name"Munkajog"descriptionDescription en texte brut, ou null.
iconIdentifiant de l'icône affichée à côté de la catégorie, ou null.
order_columnPosition de tri parmi les catégories de même niveau.
0is_activeparent_idId de la catégorie parente, ou null pour une catégorie racine.
author_idId utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.
author_nameNom affiché du créateur, ou null pour une catégorie par défaut.
articles_countNombre d'articles publiés de cette catégorie que l'appelant peut voir.
shared_rolesId des rôles avec lesquels cette catégorie est partagée. Vide signifie que seul l'auteur la voit (une catégorie par défaut dont author_id vaut 0 est visible par tous).
created_atupdated_atupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/knowledge/categories/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/knowledge/categories/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/knowledge/categories/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"name": "string"
}
Exemples de réponses
{
"data": {
"id": 42,
"slug": "munkajog",
"name": "Munkajog",
"description": "string",
"icon": "string",
"order_column": 0,
"is_active": true,
"parent_id": 1234,
"author_id": 1234,
"author_name": "string",
"articles_count": 0,
"shared_roles": [
1
],
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
E-mails
Lister les e-mails d'un dossier
/api/agent/matters/{id}/emails
Liste les e-mails enregistrés dans un dossier : nom et adresse de l'expéditeur, objet, taille et membre de l'équipe qui a enregistré chacun d'eux, du plus récemment envoyé au plus ancien. En-têtes et métadonnées uniquement, jamais le corps ni le HTML brut. Utilisez emails.get pour obtenir le corps en texte brut d'un message.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
qFiltrer par objet, nom ou adresse de l'expéditeur (sans tenir compte des accents ni de la casse). Pas le corps.
"invoice"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant de l'e-mail (à utiliser avec emails.get).
1234from_nameNom affiché de la partie externe. Le stockage ne conserve aucune colonne de sens ou de destinataire : il s'agit donc toujours de la partie externe, jamais d'un membre de l'équipe, et l'API ne peut pas indiquer si le courrier était entrant ou sortant.
from_addressAdresse SMTP de la partie externe.
subjectsent_atDate d'envoi du message. Le fuseau horaire de la valeur enregistrée varie selon le canal d'ingestion (le worker IMAP enregistre en UTC, le complément Outlook enregistre l'heure locale du fuseau du cabinet) : elle est donc fournie au mieux, et le tri de la liste sur ce champ peut être décalé du décalage UTC du cabinet d'une source à l'autre. created_at est l'horodatage fiable.
sizeTaille en octets du fichier .eml/.msg stocké.
extension"msg" (complément Outlook) ou "eml" (IMAP / par défaut) ; null sur certaines lignes anciennes.
saved_by_user_idId utilisateur du membre de l'équipe qui a enregistré l'e-mail dans Flowyer.
saved_byNom affiché de ce membre de l'équipe.
created_atDate d'enregistrement de l'e-mail dans Flowyer (heure locale du fuseau du cabinet). L'horodatage fiable pour une pagination stable.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/emails?q=invoice&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/emails?q=invoice&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/emails?q=invoice&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"from_name": "string",
"from_address": "string",
"subject": "string",
"sent_at": "2026-10-30T09:15:00+01:00",
"size": 0,
"extension": "string",
"saved_by_user_id": 1234,
"saved_by": "string",
"created_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un e-mail
/api/agent/emails/{id}
Renvoie un e-mail enregistré dans un dossier, avec son corps en texte brut (expéditeur, objet, taille et auteur de l'enregistrement). Le corps HTML brut n'est jamais renvoyé. Répond 404 lorsque l'e-mail n'existe pas ou que son dossier n'est pas visible pour l'utilisateur titulaire de cette clé API.
Paramètres de chemin
idobligatoireId de l'e-mail.
1234Réponses
200
OK.
dataobligatoireChamps de data
id1234matterLe dossier dans lequel l'e-mail est classé, ou null pour un e-mail sans dossier (enregistré hors de tout dossier).
Champs de matter
idcase_numberfrom_nameNom affiché de la partie externe (jamais un membre de l'équipe ; le stockage ne comporte pas de colonne de sens).
from_addressAdresse SMTP de la partie externe.
subjectbodyLe corps du message en texte brut. Le corps HTML brut n'est volontairement jamais renvoyé (HTML tiers non fiable). Texte brut au mieux : si le HTML d'origine contenait <style>/<script>, leur texte intérieur peut y subsister.
sent_atDate d'envoi du message. Le fuseau horaire varie selon le canal de réception (IMAP stocke en UTC, le complément Outlook en heure locale du fuseau du cabinet) ; created_at est l'horodatage fiable.
sizeTaille en octets du fichier .eml/.msg stocké.
extension"msg" ou "eml" ; null sur certaines lignes anciennes.
saved_by_user_idId utilisateur du membre de l'équipe qui a enregistré l'e-mail dans Flowyer.
saved_byNom affiché de ce membre de l'équipe.
created_atDate d'enregistrement de l'e-mail dans Flowyer (heure locale du fuseau du cabinet).
updated_at
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/emails/1234' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/emails/1234", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/emails/1234",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 1234,
"matter": {
"id": 1234,
"case_number": "string"
},
"from_name": "string",
"from_address": "string",
"subject": "string",
"body": "string",
"sent_at": "2026-10-30T09:15:00+01:00",
"size": 0,
"extension": "string",
"saved_by_user_id": 1234,
"saved_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00"
}
}
{
"error": "email_not_visible",
"message": "The email :id does not exist, or is on a matter that is not visible to the user who owns this API key.",
"message_localized": "L'e-mail :id n'existe pas ou est rattaché à un dossier qui n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"email_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Historique de procédure
Lister l'historique de procédure d'un dossier
/api/agent/matters/{id}/litigation
Liste les entrées de l'historique de procédure (pertörténet) d'un dossier, de l'événement le plus récent au plus ancien : une note datée avec un titre, une description HTML et un lieu. Répond 404 lorsque le dossier n'est pas visible pour l'utilisateur.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id4521titleTitre de l'entrée. Texte brut.
"Első tárgyalás elhalasztva"descriptionDétails de l'entrée en HTML enrichi, nettoyé côté serveur.
locationLieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.
event_dateJour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.
user_idAuteur (l'utilisateur qui a créé l'entrée).
created_byNom affiché de l'auteur.
last_editor_idUtilisateur ayant modifié l'entrée en dernier.
last_editorNom affiché du dernier rédacteur.
created_atupdated_atTransmettez cette valeur à litigation.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/litigation?limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/litigation?limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/litigation?limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 4521,
"title": "Első tárgyalás elhalasztva",
"description": "string",
"location": "string",
"event_date": "2026-10-30",
"user_id": 1234,
"created_by": "string",
"last_editor_id": 1234,
"last_editor": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer une entrée de l'historique de procédure
/api/agent/matters/{id}/litigation
Ajoute une entrée de l'historique de procédure (pertörténet) à un dossier : un titre (texte brut, "<"/">" non autorisés), une description HTML facultative (nettoyée côté serveur), un lieu facultatif et une date d'événement (par défaut aujourd'hui). Répond 404 lorsque le dossier n'est pas visible.
Paramètres de chemin
idobligatoireDossier auquel l'entrée appartient (il doit être visible).
1234Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
titleobligatoireTitre de l'entrée, 2000 caractères au plus. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Első tárgyalás elhalasztva"descriptionDétails de l'entrée. HTML enrichi, nettoyé côté serveur avec le profil de la base de connaissances.
locationLieu de l'événement (texte brut, 255 caractères au plus) ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Fővárosi Törvényszék, 215. tárgyaló"event_dateJour de l'entrée, YYYY-MM-DD. Par défaut aujourd'hui (fuseau horaire du cabinet).
"2026-11-15"idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id4521titleTitre de l'entrée. Texte brut.
"Első tárgyalás elhalasztva"descriptionDétails de l'entrée en HTML enrichi, nettoyé côté serveur.
locationLieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.
event_dateJour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.
user_idAuteur (l'utilisateur qui a créé l'entrée).
created_byNom affiché de l'auteur.
last_editor_idUtilisateur ayant modifié l'entrée en dernier.
last_editorNom affiché du dernier rédacteur.
created_atupdated_atTransmettez cette valeur à litigation.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id4521titleTitre de l'entrée. Texte brut.
"Első tárgyalás elhalasztva"descriptionDétails de l'entrée en HTML enrichi, nettoyé côté serveur.
locationLieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.
event_dateJour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.
user_idAuteur (l'utilisateur qui a créé l'entrée).
created_byNom affiché de l'auteur.
last_editor_idUtilisateur ayant modifié l'entrée en dernier.
last_editorNom affiché du dernier rédacteur.
created_atupdated_atTransmettez cette valeur à litigation.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/litigation' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"title": "Első tárgyalás elhalasztva",
"location": "Fővárosi Törvényszék, 215. tárgyaló",
"event_date": "2026-11-15"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/litigation", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"title": "Első tárgyalás elhalasztva",
"location": "Fővárosi Törvényszék, 215. tárgyaló",
"event_date": "2026-11-15"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/litigation",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"title": "Első tárgyalás elhalasztva",
"location": "Fővárosi Törvényszék, 215. tárgyaló",
"event_date": "2026-11-15",
},
timeout=30,
)
print(response.status_code, response.json())
{
"title": "Első tárgyalás elhalasztva",
"location": "Fővárosi Törvényszék, 215. tárgyaló",
"event_date": "2026-11-15"
}
Exemples de réponses
{
"data": {
"id": 4521,
"title": "Első tárgyalás elhalasztva",
"description": "string",
"location": "string",
"event_date": "2026-10-30",
"user_id": 1234,
"created_by": "string",
"last_editor_id": 1234,
"last_editor": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 4521,
"title": "Első tárgyalás elhalasztva",
"description": "string",
"location": "string",
"event_date": "2026-10-30",
"user_id": 1234,
"created_by": "string",
"last_editor_id": 1234,
"last_editor": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"title": [
"Le champ title est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une entrée de l'historique de procédure
/api/agent/litigation/{id}
Modifie une entrée de l'historique de procédure (pertörténet) : titre, description, lieu ou date de l'événement. Seuls les champs envoyés sont écrits ; la description est nettoyée côté serveur. Transmettez expected_updated_at issu de votre dernière lecture ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
titleNouveau titre, 2000 caractères au maximum (texte brut ; "<"/">" non autorisés). Omettez-le pour conserver le titre actuel.
^[^<>]*$"Ítélethirdetés elhalasztva"descriptionNouveaux détails (HTML enrichi, nettoyé). Omettez-les pour conserver les détails actuels ; null/vide les efface.
locationNouveau lieu (texte brut, 255 caractères au maximum ; "<"/">" non autorisés). Omettez-le pour le conserver ; null/vide l'efface.
^[^<>]*$event_dateNouveau jour de l'événement, YYYY-MM-DD. Omettez-le pour le conserver ; null l'efface.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
id4521titleTitre de l'entrée. Texte brut.
"Első tárgyalás elhalasztva"descriptionDétails de l'entrée en HTML enrichi, nettoyé côté serveur.
locationLieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.
event_dateJour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.
user_idAuteur (l'utilisateur qui a créé l'entrée).
created_byNom affiché de l'auteur.
last_editor_idUtilisateur ayant modifié l'entrée en dernier.
last_editorNom affiché du dernier rédacteur.
created_atupdated_atTransmettez cette valeur à litigation.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/litigation/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "Ítélethirdetés elhalasztva"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/litigation/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "Ítélethirdetés elhalasztva"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/litigation/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "Ítélethirdetés elhalasztva",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "Ítélethirdetés elhalasztva"
}
Exemples de réponses
{
"data": {
"id": 4521,
"title": "Első tárgyalás elhalasztva",
"description": "string",
"location": "string",
"event_date": "2026-10-30",
"user_id": 1234,
"created_by": "string",
"last_editor_id": 1234,
"last_editor": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Registre du courrier
Lister le registre du courrier
/api/agent/mail-register
Liste les entrées du registre du courrier (Postakönyv) enregistrées sur les dossiers que l'utilisateur peut voir, des plus récentes aux plus anciennes. Filtrez par dossier, sens, texte libre (objet/expéditeur/destinataire/numéro de suivi) et période. Le courrier des dossiers archivés est masqué, sauf si include_archived vaut true.
Paramètres de requête
matter_idUniquement les entrées de ce dossier (il doit être visible pour l'utilisateur).
1234directionUniquement les entrées à l'arrivée (reçues) ou au départ (envoyées).
"incoming" "outgoing" qRecherche en texte libre dans l'objet, l'expéditeur, le destinataire, le réceptionnaire et le numéro de suivi (sans distinction de casse).
"Kúria"date_fromUniquement les entrées dont la date est égale ou postérieure à ce jour (YYYY-MM-DD).
"2026-01-01"date_toUniquement les entrées dont la date est égale ou antérieure à ce jour (YYYY-MM-DD).
"2026-12-31"updated_sinceUniquement les entrées modifiées à partir de cet instant (ISO 8601).
"2026-10-01T00:00:00+02:00"include_archivedInclure les entrées des dossiers archivés.
falselimitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).
4321matterLe dossier sur lequel l'entrée est enregistrée.
Champs de matter
idcase_numberdirectionincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateDate postale/d'enregistrement, YYYY-MM-DD (sans heure).
subjectsenderFeladó : l'expéditeur (texte libre).
toCímzett : le destinataire (texte libre).
recipientPour un courrier à l'arrivée : le nom affiché du membre de l'équipe qui l'a reçu. Pour un courrier au départ : le destinataire/réceptionnaire en texte libre.
recipient_user_idRenseigné uniquement pour un courrier à l'arrivée dont le réceptionnaire est un membre de l'équipe (un identifiant d'utilisateur) ; null pour un courrier au départ.
electronicTrue lorsque l'élément a été enregistré comme électronique (type_of_mail).
delivery_method_idIdentifiant du mode de remise (mail_delivery_methods).
delivery_methodLibellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.
tracking_noAzonosító : numéro de suivi.
folder_pathrecorded_by_user_idLe membre de l'équipe qui a enregistré l'entrée.
recorded_bycreated_atupdated_atTransmettez cette valeur à mail_register.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/mail-register?matter_id=1234&q=K%C3%BAria&date_from=2026-01-01' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/mail-register?matter_id=1234&q=K%C3%BAria&date_from=2026-01-01", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/mail-register?matter_id=1234&q=K%C3%BAria&date_from=2026-01-01",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"direction": "incoming",
"date": "2026-10-30",
"subject": "string",
"sender": "string",
"to": "string",
"recipient": "string",
"recipient_user_id": 1234,
"electronic": true,
"delivery_method_id": 1234,
"delivery_method": "string",
"tracking_no": "string",
"folder_path": "string",
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"mail_register:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"mail_register:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "mail_register:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une entrée du registre du courrier
/api/agent/mail-register/{id}
Renvoie une entrée du registre du courrier (Postakönyv) par son identifiant, avec son updated_at (le jeton qu'accepte mail_register.update). Répond 404 lorsque l'entrée n'existe pas ou que son dossier n'est pas visible pour l'utilisateur.
Paramètres de chemin
idobligatoireIdentifiant de l'entrée du registre du courrier.
4321Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).
4321matterLe dossier sur lequel l'entrée est enregistrée.
Champs de matter
idcase_numberdirectionincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateDate postale/d'enregistrement, YYYY-MM-DD (sans heure).
subjectsenderFeladó : l'expéditeur (texte libre).
toCímzett : le destinataire (texte libre).
recipientPour un courrier à l'arrivée : le nom affiché du membre de l'équipe qui l'a reçu. Pour un courrier au départ : le destinataire/réceptionnaire en texte libre.
recipient_user_idRenseigné uniquement pour un courrier à l'arrivée dont le réceptionnaire est un membre de l'équipe (un identifiant d'utilisateur) ; null pour un courrier au départ.
electronicTrue lorsque l'élément a été enregistré comme électronique (type_of_mail).
delivery_method_idIdentifiant du mode de remise (mail_delivery_methods).
delivery_methodLibellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.
tracking_noAzonosító : numéro de suivi.
folder_pathrecorded_by_user_idLe membre de l'équipe qui a enregistré l'entrée.
recorded_bycreated_atupdated_atTransmettez cette valeur à mail_register.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/mail-register/4321' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/mail-register/4321", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/mail-register/4321",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"direction": "incoming",
"date": "2026-10-30",
"subject": "string",
"sender": "string",
"to": "string",
"recipient": "string",
"recipient_user_id": 1234,
"electronic": true,
"delivery_method_id": 1234,
"delivery_method": "string",
"tracking_no": "string",
"folder_path": "string",
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "mail",
"record_id": 4321
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer une entrée du registre du courrier
/api/agent/mail-register
Enregistre une nouvelle entrée du registre du courrier (Postakönyv) sur un dossier. Utilisez recipient_user_id pour un courrier à l'arrivée reçu par un membre de l'équipe, ou recipient (texte libre) pour un courrier au départ. delivery_method_id doit correspondre à un mode connu. Répond 404 lorsque le dossier n'est pas visible.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
matter_idobligatoireDossier auquel l'entrée appartient (il doit être visible).
1234directionobligatoireincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateobligatoireDate postale/d'enregistrement, YYYY-MM-DD (sans heure).
"2026-11-03"subjectobligatoireObjet de la correspondance. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Fellebbezés a Kúriához"senderFeladó : l'expéditeur (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$toCímzett : le destinataire (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$recipientCourrier au départ : le destinataire/réceptionnaire en texte libre. Non autorisé avec recipient_user_id. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$recipient_user_idCourrier à l'arrivée : le membre de l'équipe qui l'a reçu (un identifiant d'utilisateur issu de colleagues.list), enregistré comme réceptionnaire numérique. Non autorisé avec recipient.
electronicIndique si l'élément est électronique (type_of_mail) ; indépendant du mode de remise. Valeur par défaut : false.
falsedelivery_method_idIdentifiant du mode de remise (mail_delivery_methods) : par exemple 1 Posta, 4 Cégkapu, 7 Perkapu. 422 s'il est inconnu.
tracking_noAzonosító : numéro de suivi. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$folder_path^[^<>]*$idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
idIdentifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).
4321matterLe dossier sur lequel l'entrée est enregistrée.
Champs de matter
idcase_numberdirectionincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateDate postale/d'enregistrement, YYYY-MM-DD (sans heure).
subjectsenderFeladó : l'expéditeur (texte libre).
toCímzett : le destinataire (texte libre).
recipientPour un courrier à l'arrivée : le nom affiché du membre de l'équipe qui l'a reçu. Pour un courrier au départ : le destinataire/réceptionnaire en texte libre.
recipient_user_idRenseigné uniquement pour un courrier à l'arrivée dont le réceptionnaire est un membre de l'équipe (un identifiant d'utilisateur) ; null pour un courrier au départ.
electronicTrue lorsque l'élément a été enregistré comme électronique (type_of_mail).
delivery_method_idIdentifiant du mode de remise (mail_delivery_methods).
delivery_methodLibellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.
tracking_noAzonosító : numéro de suivi.
folder_pathrecorded_by_user_idLe membre de l'équipe qui a enregistré l'entrée.
recorded_bycreated_atupdated_atTransmettez cette valeur à mail_register.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
idIdentifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).
4321matterLe dossier sur lequel l'entrée est enregistrée.
Champs de matter
idcase_numberdirectionincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateDate postale/d'enregistrement, YYYY-MM-DD (sans heure).
subjectsenderFeladó : l'expéditeur (texte libre).
toCímzett : le destinataire (texte libre).
recipientPour un courrier à l'arrivée : le nom affiché du membre de l'équipe qui l'a reçu. Pour un courrier au départ : le destinataire/réceptionnaire en texte libre.
recipient_user_idRenseigné uniquement pour un courrier à l'arrivée dont le réceptionnaire est un membre de l'équipe (un identifiant d'utilisateur) ; null pour un courrier au départ.
electronicTrue lorsque l'élément a été enregistré comme électronique (type_of_mail).
delivery_method_idIdentifiant du mode de remise (mail_delivery_methods).
delivery_methodLibellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.
tracking_noAzonosító : numéro de suivi.
folder_pathrecorded_by_user_idLe membre de l'équipe qui a enregistré l'entrée.
recorded_bycreated_atupdated_atTransmettez cette valeur à mail_register.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/mail-register' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"matter_id": 1234,
"direction": "incoming",
"date": "2026-11-03",
"subject": "Fellebbezés a Kúriához"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/mail-register", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"matter_id": 1234,
"direction": "incoming",
"date": "2026-11-03",
"subject": "Fellebbezés a Kúriához"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/mail-register",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"matter_id": 1234,
"direction": "incoming",
"date": "2026-11-03",
"subject": "Fellebbezés a Kúriához",
},
timeout=30,
)
print(response.status_code, response.json())
{
"matter_id": 1234,
"direction": "incoming",
"date": "2026-11-03",
"subject": "Fellebbezés a Kúriához"
}
Exemples de réponses
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"direction": "incoming",
"date": "2026-10-30",
"subject": "string",
"sender": "string",
"to": "string",
"recipient": "string",
"recipient_user_id": 1234,
"electronic": true,
"delivery_method_id": 1234,
"delivery_method": "string",
"tracking_no": "string",
"folder_path": "string",
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"direction": "incoming",
"date": "2026-10-30",
"subject": "string",
"sender": "string",
"to": "string",
"recipient": "string",
"recipient_user_id": 1234,
"electronic": true,
"delivery_method_id": 1234,
"delivery_method": "string",
"tracking_no": "string",
"folder_path": "string",
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"matter_id": [
"Le champ matter id est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une entrée du registre du courrier
/api/agent/mail-register/{id}
Modifie une entrée du registre du courrier (Postakönyv) ; seuls les champs envoyés sont modifiés. L'entrée reste rattachée à son dossier. Transmettez expected_updated_at issu de votre dernière lecture ; une modification concurrente renvoie 409. Répond 404 lorsque l'entrée n'est pas visible.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
directionincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateDate postale/d'enregistrement, YYYY-MM-DD.
subjectObjet. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$senderFeladó : l'expéditeur (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$toCímzett : le destinataire (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$recipientCourrier au départ : le destinataire en texte libre. Non autorisé avec recipient_user_id. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$recipient_user_idCourrier à l'arrivée : le membre de l'équipe qui l'a reçu (un identifiant d'utilisateur), enregistré comme réceptionnaire numérique. Non autorisé avec recipient.
electronicIndique si l'élément est électronique (type_of_mail).
delivery_method_idIdentifiant du mode de remise (mail_delivery_methods) ; 422 s'il est inconnu.
tracking_noAzonosító : numéro de suivi. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$folder_path^[^<>]*$Réponses
200
Mis à jour.
dataobligatoireChamps de data
idIdentifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).
4321matterLe dossier sur lequel l'entrée est enregistrée.
Champs de matter
idcase_numberdirectionincoming = reçu, outgoing = envoyé.
"incoming" "outgoing" dateDate postale/d'enregistrement, YYYY-MM-DD (sans heure).
subjectsenderFeladó : l'expéditeur (texte libre).
toCímzett : le destinataire (texte libre).
recipientPour un courrier à l'arrivée : le nom affiché du membre de l'équipe qui l'a reçu. Pour un courrier au départ : le destinataire/réceptionnaire en texte libre.
recipient_user_idRenseigné uniquement pour un courrier à l'arrivée dont le réceptionnaire est un membre de l'équipe (un identifiant d'utilisateur) ; null pour un courrier au départ.
electronicTrue lorsque l'élément a été enregistré comme électronique (type_of_mail).
delivery_method_idIdentifiant du mode de remise (mail_delivery_methods).
delivery_methodLibellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.
tracking_noAzonosító : numéro de suivi.
folder_pathrecorded_by_user_idLe membre de l'équipe qui a enregistré l'entrée.
recorded_bycreated_atupdated_atTransmettez cette valeur à mail_register.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'entrée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/mail-register/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"direction": "incoming"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/mail-register/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"direction": "incoming"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/mail-register/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"direction": "incoming",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"direction": "incoming"
}
Exemples de réponses
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"direction": "incoming",
"date": "2026-10-30",
"subject": "string",
"sender": "string",
"to": "string",
"recipient": "string",
"recipient_user_id": 1234,
"electronic": true,
"delivery_method_id": 1234,
"delivery_method": "string",
"tracking_no": "string",
"folder_path": "string",
"recorded_by_user_id": 1234,
"recorded_by": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Commentaires
Lister les commentaires d'un dossier
/api/agent/matters/{id}/comments
Liste les commentaires d'un dossier, des plus anciens aux plus récents : id, auteur, corps (HTML enrichi) et le parent_id d'une réponse. Liste plate, non imbriquée - reconstruisez les fils à un niveau à partir de parent_id. Transmettez top_level_only pour exclure les réponses. Répond 404 lorsque le dossier n'est pas visible pour l'utilisateur.
Paramètres de chemin
idobligatoireIdentifiant du dossier (il doit être visible).
1234Paramètres de requête
top_level_onlyUniquement les commentaires de premier niveau (réponses exclues). Valeur par défaut : false.
falselimitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id9876matter_idLe dossier (= case_id) auquel appartient le commentaire.
parent_idLe commentaire de premier niveau auquel celui-ci répond ; null pour un commentaire de premier niveau. Les réponses ne comportent qu'un seul niveau.
author_user_idId utilisateur de l'auteur (null pour un import ancien).
author_nameNom affiché de l'auteur, ou null.
bodyLe commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.
created_atDate de publication du commentaire, ISO 8601 dans le fuseau du cabinet.
updated_atJeton de verrouillage optimiste : transmettez-le à comments.update en tant que expected_updated_at. Jeton opaque, et NON une heure réelle (il peut différer de quelques heures de l'instant réel) : utilisez created_at et edited_at pour l'affichage. null pour un ancien commentaire qui n'en a pas.
editedTrue lorsque le commentaire a été modifié depuis sa publication.
edited_atDate de la dernière modification du commentaire, ISO 8601 dans le fuseau du cabinet (l'instant réel, cohérent avec created_at). null si le commentaire n'a jamais été modifié.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/comments?limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/comments?limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/comments?limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 9876,
"matter_id": 1234,
"parent_id": 1234,
"author_user_id": 1234,
"author_name": "string",
"body": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"edited": true,
"edited_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Publier un commentaire sur un dossier
/api/agent/matters/{id}/comments
Publie un commentaire sur un dossier, ou une réponse à un niveau (parent_id = un commentaire de PREMIER NIVEAU du MÊME dossier). Le corps est du HTML enrichi, nettoyé côté serveur avant l'enregistrement. Répond 404 lorsque le dossier n'est pas visible, 422 lorsque parent_id n'est pas un commentaire de premier niveau du dossier.
Paramètres de chemin
idobligatoireIdentifiant du dossier (il doit être visible).
1234Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
bodyobligatoireLe commentaire, en HTML enrichi (tel que produit par TinyMCE). Nettoyé côté serveur par HTMLPurifier avant l'enregistrement. 100000 caractères au plus.
"<p>Egyetértek, a határidő tartható.</p>"parent_idRépondre à ce commentaire de PREMIER NIVEAU du MÊME dossier (issu de comments.list, parent_id = null) ; omettez-le pour un nouveau commentaire de premier niveau.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id9876matter_idLe dossier (= case_id) auquel appartient le commentaire.
parent_idLe commentaire de premier niveau auquel celui-ci répond ; null pour un commentaire de premier niveau. Les réponses ne comportent qu'un seul niveau.
author_user_idId utilisateur de l'auteur (null pour un import ancien).
author_nameNom affiché de l'auteur, ou null.
bodyLe commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.
created_atDate de publication du commentaire, ISO 8601 dans le fuseau du cabinet.
updated_atJeton de verrouillage optimiste : transmettez-le à comments.update en tant que expected_updated_at. Jeton opaque, et NON une heure réelle (il peut différer de quelques heures de l'instant réel) : utilisez created_at et edited_at pour l'affichage. null pour un ancien commentaire qui n'en a pas.
editedTrue lorsque le commentaire a été modifié depuis sa publication.
edited_atDate de la dernière modification du commentaire, ISO 8601 dans le fuseau du cabinet (l'instant réel, cohérent avec created_at). null si le commentaire n'a jamais été modifié.
createdtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id9876matter_idLe dossier (= case_id) auquel appartient le commentaire.
parent_idLe commentaire de premier niveau auquel celui-ci répond ; null pour un commentaire de premier niveau. Les réponses ne comportent qu'un seul niveau.
author_user_idId utilisateur de l'auteur (null pour un import ancien).
author_nameNom affiché de l'auteur, ou null.
bodyLe commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.
created_atDate de publication du commentaire, ISO 8601 dans le fuseau du cabinet.
updated_atJeton de verrouillage optimiste : transmettez-le à comments.update en tant que expected_updated_at. Jeton opaque, et NON une heure réelle (il peut différer de quelques heures de l'instant réel) : utilisez created_at et edited_at pour l'affichage. null pour un ancien commentaire qui n'en a pas.
editedTrue lorsque le commentaire a été modifié depuis sa publication.
edited_atDate de la dernière modification du commentaire, ISO 8601 dans le fuseau du cabinet (l'instant réel, cohérent avec created_at). null si le commentaire n'a jamais été modifié.
createdfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/comments' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"body": "<p>Egyetértek, a határidő tartható.</p>"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/comments", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"body": "<p>Egyetértek, a határidő tartható.</p>"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/comments",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"body": "<p>Egyetértek, a határidő tartható.</p>",
},
timeout=30,
)
print(response.status_code, response.json())
{
"body": "<p>Egyetértek, a határidő tartható.</p>"
}
Exemples de réponses
{
"data": {
"id": 9876,
"matter_id": 1234,
"parent_id": 1234,
"author_user_id": 1234,
"author_name": "string",
"body": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"edited": true,
"edited_at": "2026-10-30T09:15:00+01:00"
},
"created": true
}
{
"data": {
"id": 9876,
"matter_id": 1234,
"parent_id": 1234,
"author_user_id": 1234,
"author_name": "string",
"body": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"edited": true,
"edited_at": "2026-10-30T09:15:00+01:00"
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"body": [
"Le champ body est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier son propre commentaire sur un dossier
/api/agent/comments/{id}
Modifie l'un de VOS PROPRES commentaires (son corps uniquement ; HTML enrichi, nettoyé côté serveur avant stockage). Transmettez expected_updated_at issu de votre dernière lecture ; une modification conflictuelle répond 409. Répond 404 pour un commentaire qui n'est pas le vôtre ou qui porte sur un dossier que vous ne pouvez pas voir.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
bodyobligatoireNouveau corps du commentaire, en HTML enrichi (tel que produit par TinyMCE). Nettoyé côté serveur par HTMLPurifier avant stockage. 100000 caractères au maximum.
"<p>Pontosítás: a határidő november 15.</p>"Réponses
200
Mis à jour.
dataobligatoireChamps de data
id9876matter_idLe dossier (= case_id) auquel appartient le commentaire.
parent_idLe commentaire de premier niveau auquel celui-ci répond ; null pour un commentaire de premier niveau. Les réponses ne comportent qu'un seul niveau.
author_user_idId utilisateur de l'auteur (null pour un import ancien).
author_nameNom affiché de l'auteur, ou null.
bodyLe commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.
created_atDate de publication du commentaire, ISO 8601 dans le fuseau du cabinet.
updated_atJeton de verrouillage optimiste : transmettez-le à comments.update en tant que expected_updated_at. Jeton opaque, et NON une heure réelle (il peut différer de quelques heures de l'instant réel) : utilisez created_at et edited_at pour l'affichage. null pour un ancien commentaire qui n'en a pas.
editedTrue lorsque le commentaire a été modifié depuis sa publication.
edited_atDate de la dernière modification du commentaire, ISO 8601 dans le fuseau du cabinet (l'instant réel, cohérent avec created_at). null si le commentaire n'a jamais été modifié.
updatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/comments/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"body": "<p>Pontosítás: a határidő november 15.</p>"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/comments/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"body": "<p>Pontosítás: a határidő november 15.</p>"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/comments/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"body": "<p>Pontosítás: a határidő november 15.</p>",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"body": "<p>Pontosítás: a határidő november 15.</p>"
}
Exemples de réponses
{
"data": {
"id": 9876,
"matter_id": 1234,
"parent_id": 1234,
"author_user_id": 1234,
"author_name": "string",
"body": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"edited": true,
"edited_at": "2026-10-30T09:15:00+01:00"
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Audiences
Lister les audiences d'un dossier
/api/agent/matters/{id}/trials
Liste les audiences (tárgyalások) d'un dossier : date, juridiction, lieu, membres de l'équipe présents et juge, des plus récentes aux plus anciennes. Filtrage facultatif par période from/to ou par updated_since. Répond 404 lorsque le dossier n'est pas visible pour l'utilisateur.
Paramètres de chemin
idobligatoireIdentifiant du dossier.
1234Paramètres de requête
fromUniquement les audiences ayant lieu ce jour ou après (YYYY-MM-DD), dans le fuseau horaire du cabinet.
"2026-01-01"toUniquement les audiences ayant lieu ce jour ou avant (YYYY-MM-DD), dans le fuseau horaire du cabinet.
"2026-12-31"updated_sinceUniquement les audiences modifiées à partir de cet instant ISO 8601.
limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id4321matterLe dossier auquel l'audience appartient.
Champs de matter
idcase_numberdateDate et heure de l'audience, ISO 8601 dans le fuseau horaire du cabinet. Elle est enregistrée en UTC : comparez donc les instants plutôt que le texte de l'heure locale.
"2026-03-02T09:00:00+01:00"participationIndique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.
"required" "not_required" courtLa juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.
Champs de court
idnamecityzipaddresssourceToujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.
placeSalle ou lieu de l'audience. Texte brut.
name_of_the_judgeNom du juge. Texte brut.
notesNotes libres sur l'audience. Texte brut.
responsiblesMembres de l'équipe présents à l'audience (identifiants issus de colleagues.list).
Champs de responsibles
user_idnamerecorded_byLe membre de l'équipe qui a enregistré l'audience.
Champs de recorded_by
user_idnamecreated_atupdated_atTransmettez cette valeur à trials.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/matters/1234/trials?from=2026-01-01&to=2026-12-31&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/trials?from=2026-01-01&to=2026-12-31&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/matters/1234/trials?from=2026-01-01&to=2026-12-31&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"date": "2026-03-02T09:00:00+01:00",
"participation": "required",
"court": {
"id": 1234,
"name": "string",
"city": "string",
"zip": "string",
"address": "string",
"source": "string"
},
"place": "string",
"name_of_the_judge": "string",
"notes": "string",
"responsibles": [
{
"user_id": 1234,
"name": "string"
}
],
"recorded_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "matter_not_visible",
"message": "The matter 1234 does not exist, is archived, or is not visible to the user who owns this API key.",
"message_localized": "Le dossier 1234 n'existe pas, est archivé ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"matter_id": 1234
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une audience
/api/agent/trials/{id}
Renvoie une audience (tárgyalás) avec son dossier, sa juridiction, les membres de l'équipe présents et le jeton de verrouillage updated_at pour trials.update. Répond 404 lorsque l'audience n'existe pas ou que l'utilisateur ne peut pas voir son dossier.
Paramètres de chemin
idobligatoireIdentifiant de l'audience.
4321Réponses
200
OK.
dataobligatoireChamps de data
id4321matterLe dossier auquel l'audience appartient.
Champs de matter
idcase_numberdateDate et heure de l'audience, ISO 8601 dans le fuseau horaire du cabinet. Elle est enregistrée en UTC : comparez donc les instants plutôt que le texte de l'heure locale.
"2026-03-02T09:00:00+01:00"participationIndique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.
"required" "not_required" courtLa juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.
Champs de court
idnamecityzipaddresssourceToujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.
placeSalle ou lieu de l'audience. Texte brut.
name_of_the_judgeNom du juge. Texte brut.
notesNotes libres sur l'audience. Texte brut.
responsiblesMembres de l'équipe présents à l'audience (identifiants issus de colleagues.list).
Champs de responsibles
user_idnamerecorded_byLe membre de l'équipe qui a enregistré l'audience.
Champs de recorded_by
user_idnamecreated_atupdated_atTransmettez cette valeur à trials.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/trials/4321' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/trials/4321", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/trials/4321",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"date": "2026-03-02T09:00:00+01:00",
"participation": "required",
"court": {
"id": 1234,
"name": "string",
"city": "string",
"zip": "string",
"address": "string",
"source": "string"
},
"place": "string",
"name_of_the_judge": "string",
"notes": "string",
"responsibles": [
{
"user_id": 1234,
"name": "string"
}
],
"recorded_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "trial",
"record_id": 4321
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer une audience
/api/agent/matters/{id}/trials
Enregistre une audience (tárgyalás) sur un dossier : heure, juridiction facultative (court_id issu de courts.list), salle, juge, notes et membres de l'équipe présents. Le dossier doit être visible et non archivé ; les participants sont notifiés. Une heure sans décalage est interprétée dans le fuseau du cabinet.
Paramètres de chemin
idobligatoireDossier auquel l'audience appartient (il doit être visible et non archivé).
1234Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
dateobligatoireDate et heure de l'audience, ISO 8601. Un décalage éventuel est respecté ; sans décalage, l'heure est interprétée dans le fuseau horaire du cabinet. Enregistrée en UTC.
"2026-03-02T09:00:00+01:00"court_idJuridiction de l'audience : un identifiant issu de courts.list (le registre partagé des juridictions). Omettez-le lorsque la juridiction n'est pas connue.
42participationIndique si la présence d'un membre de l'équipe est requise. Omettez-le pour ne pas le renseigner.
"required" "not_required" placeSalle ou lieu de l'audience. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"II. emelet 205."name_of_the_judgeNom du juge. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$notesNotes libres sur l'audience. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$responsible_user_idsIdentifiants d'utilisateur (issus de colleagues.list) des membres de l'équipe présents à l'audience.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id4321matterLe dossier auquel l'audience appartient.
Champs de matter
idcase_numberdateDate et heure de l'audience, ISO 8601 dans le fuseau horaire du cabinet. Elle est enregistrée en UTC : comparez donc les instants plutôt que le texte de l'heure locale.
"2026-03-02T09:00:00+01:00"participationIndique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.
"required" "not_required" courtLa juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.
Champs de court
idnamecityzipaddresssourceToujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.
placeSalle ou lieu de l'audience. Texte brut.
name_of_the_judgeNom du juge. Texte brut.
notesNotes libres sur l'audience. Texte brut.
responsiblesMembres de l'équipe présents à l'audience (identifiants issus de colleagues.list).
Champs de responsibles
user_idnamerecorded_byLe membre de l'équipe qui a enregistré l'audience.
Champs de recorded_by
user_idnamecreated_atupdated_atTransmettez cette valeur à trials.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id4321matterLe dossier auquel l'audience appartient.
Champs de matter
idcase_numberdateDate et heure de l'audience, ISO 8601 dans le fuseau horaire du cabinet. Elle est enregistrée en UTC : comparez donc les instants plutôt que le texte de l'heure locale.
"2026-03-02T09:00:00+01:00"participationIndique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.
"required" "not_required" courtLa juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.
Champs de court
idnamecityzipaddresssourceToujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.
placeSalle ou lieu de l'audience. Texte brut.
name_of_the_judgeNom du juge. Texte brut.
notesNotes libres sur l'audience. Texte brut.
responsiblesMembres de l'équipe présents à l'audience (identifiants issus de colleagues.list).
Champs de responsibles
user_idnamerecorded_byLe membre de l'équipe qui a enregistré l'audience.
Champs de recorded_by
user_idnamecreated_atupdated_atTransmettez cette valeur à trials.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/matters/1234/trials' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"date": "2026-03-02T09:00:00+01:00",
"court_id": 42,
"place": "II. emelet 205."
}'
const response = await fetch("https://www.flowyer.fr/api/agent/matters/1234/trials", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"date": "2026-03-02T09:00:00+01:00",
"court_id": 42,
"place": "II. emelet 205."
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/matters/1234/trials",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"date": "2026-03-02T09:00:00+01:00",
"court_id": 42,
"place": "II. emelet 205.",
},
timeout=30,
)
print(response.status_code, response.json())
{
"date": "2026-03-02T09:00:00+01:00",
"court_id": 42,
"place": "II. emelet 205."
}
Exemples de réponses
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"date": "2026-03-02T09:00:00+01:00",
"participation": "required",
"court": {
"id": 1234,
"name": "string",
"city": "string",
"zip": "string",
"address": "string",
"source": "string"
},
"place": "string",
"name_of_the_judge": "string",
"notes": "string",
"responsibles": [
{
"user_id": 1234,
"name": "string"
}
],
"recorded_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"date": "2026-03-02T09:00:00+01:00",
"participation": "required",
"court": {
"id": 1234,
"name": "string",
"city": "string",
"zip": "string",
"address": "string",
"source": "string"
},
"place": "string",
"name_of_the_judge": "string",
"notes": "string",
"responsibles": [
{
"user_id": 1234,
"name": "string"
}
],
"recorded_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"date": [
"Le champ date est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une audience
/api/agent/trials/{id}
Modifie une audience (tárgyalás) : heure, juridiction, lieu, juge, notes, indicateur de présence et participants. Seuls les champs envoyés sont écrits ; envoyez responsible_user_ids pour remplacer toute la liste des participants. Transmettez expected_updated_at issu de votre dernière lecture ; une modification concurrente renvoie 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
dateNouvelle date et heure de l'audience, ISO 8601 (un décalage est respecté, une heure sans fuseau est interprétée dans le fuseau du cabinet). Enregistrée en UTC.
"2026-03-02T09:00:00+01:00"court_idNouvel identifiant de juridiction issu de courts.list ; null pour retirer la juridiction.
participationIndique si la présence d'un membre de l'équipe est requise ; null pour l'effacer.
"required" "not_required" placeSalle ou lieu. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.
^[^<>]*$name_of_the_judgeNom du juge. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.
^[^<>]*$notesNotes libres. Texte brut ; "<" et ">" ne sont pas autorisés. "" les efface.
^[^<>]*$responsible_user_idsEnsemble complet de remplacement des identifiants d'utilisateur des participants (issus de colleagues.list). Omettez-le pour ne pas modifier les participants.
Réponses
200
Mis à jour.
dataobligatoireChamps de data
id4321matterLe dossier auquel l'audience appartient.
Champs de matter
idcase_numberdateDate et heure de l'audience, ISO 8601 dans le fuseau horaire du cabinet. Elle est enregistrée en UTC : comparez donc les instants plutôt que le texte de l'heure locale.
"2026-03-02T09:00:00+01:00"participationIndique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.
"required" "not_required" courtLa juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.
Champs de court
idnamecityzipaddresssourceToujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.
placeSalle ou lieu de l'audience. Texte brut.
name_of_the_judgeNom du juge. Texte brut.
notesNotes libres sur l'audience. Texte brut.
responsiblesMembres de l'équipe présents à l'audience (identifiants issus de colleagues.list).
Champs de responsibles
user_idnamerecorded_byLe membre de l'équipe qui a enregistré l'audience.
Champs de recorded_by
user_idnamecreated_atupdated_atTransmettez cette valeur à trials.update en tant que expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/trials/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-02T09:00:00+01:00"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/trials/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-02T09:00:00+01:00"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/trials/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-02T09:00:00+01:00",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-02T09:00:00+01:00"
}
Exemples de réponses
{
"data": {
"id": 4321,
"matter": {
"id": 1234,
"case_number": "string"
},
"date": "2026-03-02T09:00:00+01:00",
"participation": "required",
"court": {
"id": 1234,
"name": "string",
"city": "string",
"zip": "string",
"address": "string",
"source": "string"
},
"place": "string",
"name_of_the_judge": "string",
"notes": "string",
"responsibles": [
{
"user_id": 1234,
"name": "string"
}
],
"recorded_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Juridictions
Lister les juridictions
/api/agent/courts
Liste le registre partagé des juridictions (id, nom, ville) pour le court_id de trials.create / trials.update. Avec q (un nom de juridiction tel qu'entendu ; accents, casse et petites fautes de frappe tolérés), renvoie le statut exact/similar/none : seul "exact" peut être utilisé directement en toute sécurité. Il s'agit de l'annuaire des juridictions hongroises.
Paramètres de requête
qNom de la juridiction à rechercher, tel qu'entendu ou dicté, dans n'importe quel ordre des mots. Omettez-le pour lister toutes les juridictions.
"Fővárosi Törvényszék"limitNombre maximal de juridictions à renvoyer (par défaut 200).
200Réponses
200
OK.
dataobligatoireChamps de data
statusUniquement avec q : exact = une correspondance sûre (son id peut être utilisé en toute sécurité), similar = correspondance approchante ou multiple (à confirmer d'abord avec l'utilisateur), none = aucune correspondance (interrogez l'utilisateur). Null sans q.
"exact" "similar" "none" courtsJuridictions, meilleure correspondance en premier avec q, sinon par nom.
Champs de courts
idId de la juridiction : transmettez-le comme court_id à trials.create / trials.update.
nameNom de la juridiction tel qu'affiché dans Flowyer.
cityzipaddresstotalNombre de juridictions correspondantes (toutes les juridictions sans q) avant que la liste ne soit tronquée à limit.
truncatedTrue lorsque plus de juridictions correspondaient que celles renvoyées : affinez q ou augmentez limit.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/courts?q=F%C5%91v%C3%A1rosi%20T%C3%B6rv%C3%A9nysz%C3%A9k' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/courts?q=F%C5%91v%C3%A1rosi%20T%C3%B6rv%C3%A9nysz%C3%A9k", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/courts?q=F%C5%91v%C3%A1rosi%20T%C3%B6rv%C3%A9nysz%C3%A9k",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"status": "exact",
"courts": [
{
"id": 1234,
"name": "string",
"city": "string",
"zip": "string",
"address": "string"
}
],
"total": 1,
"truncated": true
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"courts:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"courts:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "courts:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
RH
Lister les absences de l'équipe
/api/agent/hr/leaves
Liste les absences approuvées des membres de l'équipe (qui est ou sera absent) : le membre de l'équipe, les dates de début/fin, le nombre de jours ouvrés, une catégorie expurgée pour des raisons de confidentialité (leave/unpaid ; la maladie est fusionnée dans leave et n'est jamais identifiable) et l'éventuel remplaçant. Ne renvoie jamais le type d'absence, les notes ni l'auteur de l'approbation.
Paramètres de requête
user_idUniquement les absences de ce membre de l'équipe. Un id utilisateur central (issu de colleagues.list), mis en correspondance avec le salarié concerné par l'absence.
1234on_dateQui est absent précisément ce jour-là (start_date <= on_date <= end_date). S'il est défini, il prévaut sur date_from, date_to et timeframe.
date_fromUniquement les absences encore en cours à cette date ou après (end_date >= date_from). Par défaut aujourd'hui : les absences entièrement passées sont donc exclues par défaut.
date_toUniquement les absences commençant à cette date ou avant (start_date <= date_to). Omettez-le pour un futur sans limite.
timeframeContrainte supplémentaire sur la date de début par rapport à aujourd'hui : current = déjà commencée (en cours), upcoming = pas encore commencée, all = aucune contrainte. Ignoré lorsque on_date est défini.
"current" "upcoming" "all" "all"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idId de la demande d'absence (simple référence ; non sensible).
user_idLe membre de l'équipe absent (id utilisateur central).
userNom affiché du membre de l'équipe.
start_datePremier jour d'absence (YYYY-MM-DD).
end_dateDernier jour d'absence, inclus (YYYY-MM-DD).
days_countJours ouvrés d'absence. Ne révèle pas le type.
categoryType d'absence expurgé pour des raisons de confidentialité : les congés annuels et la maladie deviennent tous deux "leave" (la maladie n'est jamais identifiable), le congé sans solde reste "unpaid". Le type d'absence brut n'est jamais exposé.
"leave" "unpaid" statusToujours "approved" : seules les absences approuvées sont renvoyées ; pending, rejected et cancelled n'apparaissent jamais.
"approved" substitute_user_idMembre de l'équipe remplaçant pendant cette absence (id utilisateur central), ou null.
substitute_userNom affiché du remplaçant, ou null.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/hr/leaves?user_id=1234&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/hr/leaves?user_id=1234&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/hr/leaves?user_id=1234&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 1234,
"user_id": 1234,
"user": "string",
"start_date": "2026-10-30",
"end_date": "2026-10-30",
"days_count": 0,
"category": "leave",
"status": "approved",
"substitute_user_id": 1234,
"substitute_user": "string"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"hr:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"hr:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "hr:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Agenda
Lister les événements de l'agenda
/api/agent/calendar/events
Liste les événements d'agenda chevauchant une plage de dates [from, to] : l'agenda du cabinet, le vôtre et les agendas partagés avec vous. Les événements récurrents sont renvoyés une seule fois (is_recurring), NON développés. Triés par début. Un événement personnel non partagé avec vous n'apparaît jamais.
Paramètres de requête
fromobligatoireDébut de la plage (inclus), ISO 8601. Les événements chevauchant [from, to] sont renvoyés. Une heure sans décalage est interprétée dans le fuseau du cabinet.
"2026-03-01T00:00:00+01:00"toobligatoireFin de la plage (incluse), ISO 8601. Doit être égale ou postérieure à from (sinon 422) et au plus 366 jours après.
"2026-03-31T23:59:59+01:00"calendar_idsRestreint à ces id d'agendas conteneurs ; chacun est croisé avec les agendas que vous pouvez consulter, de sorte qu'un id non visible pour vous est ignoré sans avertissement. Omettez-le pour tous les agendas visibles.
include_recurringInclut les événements maîtres récurrents dont la règle chevauche la plage (renvoyés non développés, is_recurring = true). Par défaut true.
truelimitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id5501calendarL'agenda auquel appartient l'événement.
Champs de calendar
idId de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).
nametype"office" = l'agenda partagé du cabinet (tout utilisateur du cabinet peut le consulter et le modifier) ; "personal" = l'agenda propre d'un utilisateur, visible uniquement par son propriétaire et les personnes avec qui il est partagé.
"office" "personal" ownerPropriétaire d'un agenda personnel ; null pour l'agenda du cabinet.
Champs de owner
user_idnametitleTitre de l'événement. Texte brut.
descriptionDescription de l'événement. Texte brut.
locationLieu. Texte brut.
participantsParticipants, texte libre. Texte brut.
startÉvénement sur la journée entière : la date de début "YYYY-MM-DD". Événement horaire : ISO 8601 dans le fuseau horaire du cabinet (l'instant UTC stocké).
"2026-03-02T09:00:00+01:00"endMême encodage que start. Pour un événement sur la journée entière, la date de fin est INCLUSE (la valeur stockée, et non la valeur +1 jour utilisée par une grille d'agenda). Null lorsque l'événement n'a pas de fin.
all_dayTrue pour un événement sur la journée entière (start/end sont de simples dates) ; false pour un événement horaire (start/end sont des instants ISO 8601).
colorCouleur d'affichage, par exemple "#2c7be5".
is_recurringTrue lorsque l'événement est un maître récurrent. Les événements récurrents sont renvoyés une seule fois, NON développés en occurrences, et ne peuvent pas être modifiés via calendar.events.update.
recurrenceLa règle de récurrence d'un événement maître récurrent, ou null pour un événement unique. En lecture seule.
Champs de recurrence
freqdaily | weekly | monthly | yearly.
intervalbyweekdayCodes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").
untilcountcreated_byLe membre de l'équipe qui a créé l'événement.
Champs de created_by
user_idnamecreated_atupdated_atTransmettez cette valeur à calendar.events.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/calendar/events?from=2026-03-01T00%3A00%3A00%2B01%3A00&to=2026-03-31T23%3A59%3A59%2B01%3A00&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/calendar/events?from=2026-03-01T00%3A00%3A00%2B01%3A00&to=2026-03-31T23%3A59%3A59%2B01%3A00&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/calendar/events?from=2026-03-01T00%3A00%3A00%2B01%3A00&to=2026-03-31T23%3A59%3A59%2B01%3A00&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 5501,
"calendar": {
"id": 1234,
"name": "string",
"type": "office",
"owner": {
"user_id": 1234,
"name": "string"
}
},
"title": "string",
"description": "string",
"location": "string",
"participants": "string",
"start": "2026-03-02T09:00:00+01:00",
"end": "string",
"all_day": true,
"color": "string",
"is_recurring": true,
"recurrence": {
"freq": "string",
"interval": 0,
"byweekday": "string",
"until": "string",
"count": 0
},
"created_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"calendar:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"calendar:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "calendar:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un événement d'agenda
/api/agent/calendar/events/{id}
Renvoie un événement d'agenda avec son agenda, le résumé de sa récurrence et le jeton de verrouillage updated_at pour calendar.events.update. Répond 404 lorsque l'événement n'existe pas ou que son agenda n'est pas visible pour l'utilisateur.
Paramètres de chemin
idobligatoireId de l'événement.
5501Réponses
200
OK.
dataobligatoireChamps de data
id5501calendarL'agenda auquel appartient l'événement.
Champs de calendar
idId de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).
nametype"office" = l'agenda partagé du cabinet (tout utilisateur du cabinet peut le consulter et le modifier) ; "personal" = l'agenda propre d'un utilisateur, visible uniquement par son propriétaire et les personnes avec qui il est partagé.
"office" "personal" ownerPropriétaire d'un agenda personnel ; null pour l'agenda du cabinet.
Champs de owner
user_idnametitleTitre de l'événement. Texte brut.
descriptionDescription de l'événement. Texte brut.
locationLieu. Texte brut.
participantsParticipants, texte libre. Texte brut.
startÉvénement sur la journée entière : la date de début "YYYY-MM-DD". Événement horaire : ISO 8601 dans le fuseau horaire du cabinet (l'instant UTC stocké).
"2026-03-02T09:00:00+01:00"endMême encodage que start. Pour un événement sur la journée entière, la date de fin est INCLUSE (la valeur stockée, et non la valeur +1 jour utilisée par une grille d'agenda). Null lorsque l'événement n'a pas de fin.
all_dayTrue pour un événement sur la journée entière (start/end sont de simples dates) ; false pour un événement horaire (start/end sont des instants ISO 8601).
colorCouleur d'affichage, par exemple "#2c7be5".
is_recurringTrue lorsque l'événement est un maître récurrent. Les événements récurrents sont renvoyés une seule fois, NON développés en occurrences, et ne peuvent pas être modifiés via calendar.events.update.
recurrenceLa règle de récurrence d'un événement maître récurrent, ou null pour un événement unique. En lecture seule.
Champs de recurrence
freqdaily | weekly | monthly | yearly.
intervalbyweekdayCodes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").
untilcountcreated_byLe membre de l'équipe qui a créé l'événement.
Champs de created_by
user_idnamecreated_atupdated_atTransmettez cette valeur à calendar.events.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/calendar/events/5501' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/calendar/events/5501", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/calendar/events/5501",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 5501,
"calendar": {
"id": 1234,
"name": "string",
"type": "office",
"owner": {
"user_id": 1234,
"name": "string"
}
},
"title": "string",
"description": "string",
"location": "string",
"participants": "string",
"start": "2026-03-02T09:00:00+01:00",
"end": "string",
"all_day": true,
"color": "string",
"is_recurring": true,
"recurrence": {
"freq": "string",
"interval": 0,
"byweekday": "string",
"until": "string",
"count": 0
},
"created_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "calendar_event",
"record_id": 5501
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer un événement d'agenda
/api/agent/calendar/events
Crée un événement d'agenda unique (horaire ou sur la journée entière). Par défaut dans votre agenda personnel ; transmettez calendar_id pour cibler l'agenda du cabinet ou tout agenda que vous pouvez modifier. Un start/end horaire respecte un décalage ISO 8601 ; une fin sur la journée entière est incluse. Les événements récurrents ne sont pas créés ici.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
titleobligatoireTitre de l'événement. Texte brut ; "<" et ">" ne sont pas autorisés (il est repris sans échappement dans la notification de rappel).
^[^<>]*$"Ügyfél egyeztetés"startobligatoireJournée entière (all_day true) : une date "YYYY-MM-DD". Horaire (all_day false) : ISO 8601 ; un décalage est respecté, une heure sans fuseau est interprétée dans le fuseau du cabinet.
"2026-03-02T09:00:00+01:00"endMême encodage que start. Par défaut = start. Pour un événement sur la journée entière, la date de fin est INCLUSE. Ne doit pas être antérieure à start (sinon 422).
all_dayIndique si l'événement dure toute la journée. Par défaut false (horaire).
falsecalendar_idL'agenda dans lequel créer l'événement. Par défaut : votre agenda personnel, ou l'agenda du cabinet si vous n'en avez pas. Vous devez disposer de droits de modification sur cet agenda (l'agenda du cabinet est modifiable par tout utilisateur du cabinet ; un agenda personnel uniquement par son propriétaire ou par une personne avec qui il est partagé en modification), sinon 403. Uniquement là où la fonctionnalité d'agenda personnel est activée.
locationLieu. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$descriptionDescription, texte brut (pas de HTML) ; "<" et ">" ne sont pas autorisés.
^[^<>]*$participantsParticipants, texte libre. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$colorCouleur d'affichage, par exemple "#2c7be5".
^#?[A-Za-z0-9_-]{1,31}$idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id5501calendarL'agenda auquel appartient l'événement.
Champs de calendar
idId de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).
nametype"office" = l'agenda partagé du cabinet (tout utilisateur du cabinet peut le consulter et le modifier) ; "personal" = l'agenda propre d'un utilisateur, visible uniquement par son propriétaire et les personnes avec qui il est partagé.
"office" "personal" ownerPropriétaire d'un agenda personnel ; null pour l'agenda du cabinet.
Champs de owner
user_idnametitleTitre de l'événement. Texte brut.
descriptionDescription de l'événement. Texte brut.
locationLieu. Texte brut.
participantsParticipants, texte libre. Texte brut.
startÉvénement sur la journée entière : la date de début "YYYY-MM-DD". Événement horaire : ISO 8601 dans le fuseau horaire du cabinet (l'instant UTC stocké).
"2026-03-02T09:00:00+01:00"endMême encodage que start. Pour un événement sur la journée entière, la date de fin est INCLUSE (la valeur stockée, et non la valeur +1 jour utilisée par une grille d'agenda). Null lorsque l'événement n'a pas de fin.
all_dayTrue pour un événement sur la journée entière (start/end sont de simples dates) ; false pour un événement horaire (start/end sont des instants ISO 8601).
colorCouleur d'affichage, par exemple "#2c7be5".
is_recurringTrue lorsque l'événement est un maître récurrent. Les événements récurrents sont renvoyés une seule fois, NON développés en occurrences, et ne peuvent pas être modifiés via calendar.events.update.
recurrenceLa règle de récurrence d'un événement maître récurrent, ou null pour un événement unique. En lecture seule.
Champs de recurrence
freqdaily | weekly | monthly | yearly.
intervalbyweekdayCodes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").
untilcountcreated_byLe membre de l'équipe qui a créé l'événement.
Champs de created_by
user_idnamecreated_atupdated_atTransmettez cette valeur à calendar.events.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id5501calendarL'agenda auquel appartient l'événement.
Champs de calendar
idId de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).
nametype"office" = l'agenda partagé du cabinet (tout utilisateur du cabinet peut le consulter et le modifier) ; "personal" = l'agenda propre d'un utilisateur, visible uniquement par son propriétaire et les personnes avec qui il est partagé.
"office" "personal" ownerPropriétaire d'un agenda personnel ; null pour l'agenda du cabinet.
Champs de owner
user_idnametitleTitre de l'événement. Texte brut.
descriptionDescription de l'événement. Texte brut.
locationLieu. Texte brut.
participantsParticipants, texte libre. Texte brut.
startÉvénement sur la journée entière : la date de début "YYYY-MM-DD". Événement horaire : ISO 8601 dans le fuseau horaire du cabinet (l'instant UTC stocké).
"2026-03-02T09:00:00+01:00"endMême encodage que start. Pour un événement sur la journée entière, la date de fin est INCLUSE (la valeur stockée, et non la valeur +1 jour utilisée par une grille d'agenda). Null lorsque l'événement n'a pas de fin.
all_dayTrue pour un événement sur la journée entière (start/end sont de simples dates) ; false pour un événement horaire (start/end sont des instants ISO 8601).
colorCouleur d'affichage, par exemple "#2c7be5".
is_recurringTrue lorsque l'événement est un maître récurrent. Les événements récurrents sont renvoyés une seule fois, NON développés en occurrences, et ne peuvent pas être modifiés via calendar.events.update.
recurrenceLa règle de récurrence d'un événement maître récurrent, ou null pour un événement unique. En lecture seule.
Champs de recurrence
freqdaily | weekly | monthly | yearly.
intervalbyweekdayCodes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").
untilcountcreated_byLe membre de l'équipe qui a créé l'événement.
Champs de created_by
user_idnamecreated_atupdated_atTransmettez cette valeur à calendar.events.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/calendar/events' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"title": "Ügyfél egyeztetés",
"start": "2026-03-02T09:00:00+01:00"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/calendar/events", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"title": "Ügyfél egyeztetés",
"start": "2026-03-02T09:00:00+01:00"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/calendar/events",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"title": "Ügyfél egyeztetés",
"start": "2026-03-02T09:00:00+01:00",
},
timeout=30,
)
print(response.status_code, response.json())
{
"title": "Ügyfél egyeztetés",
"start": "2026-03-02T09:00:00+01:00"
}
Exemples de réponses
{
"data": {
"id": 5501,
"calendar": {
"id": 1234,
"name": "string",
"type": "office",
"owner": {
"user_id": 1234,
"name": "string"
}
},
"title": "string",
"description": "string",
"location": "string",
"participants": "string",
"start": "2026-03-02T09:00:00+01:00",
"end": "string",
"all_day": true,
"color": "string",
"is_recurring": true,
"recurrence": {
"freq": "string",
"interval": 0,
"byweekday": "string",
"until": "string",
"count": 0
},
"created_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 5501,
"calendar": {
"id": 1234,
"name": "string",
"type": "office",
"owner": {
"user_id": 1234,
"name": "string"
}
},
"title": "string",
"description": "string",
"location": "string",
"participants": "string",
"start": "2026-03-02T09:00:00+01:00",
"end": "string",
"all_day": true,
"color": "string",
"is_recurring": true,
"recurrence": {
"freq": "string",
"interval": 0,
"byweekday": "string",
"until": "string",
"count": 0
},
"created_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"title": [
"Le champ title est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier un événement d'agenda
/api/agent/calendar/events/{id}
Modifie un événement d'agenda unique : titre, start/end, all_day, lieu, description, participants, couleur. Seuls les champs envoyés sont écrits ; "" efface location/description/participants. Un événement récurrent répond 422. Transmettez expected_updated_at issu de votre dernière lecture ; une modification conflictuelle répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
titleNouveau titre. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$startNouveau début. Journée entière : "YYYY-MM-DD". Horaire : ISO 8601 (un décalage est respecté, une heure sans fuseau est interprétée dans le fuseau du cabinet). Réencodé si all_day change.
endNouvelle fin, même encodage que start ; "" l'efface. Pour un événement sur la journée entière, la date de fin est incluse. Ne doit pas être antérieure à start (sinon 422).
all_dayS'il est envoyé, start/end sont réencodés en conséquence ; s'il est omis, la valeur all_day actuelle de la ligne est utilisée.
locationLieu. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.
^[^<>]*$descriptionDescription, texte brut (pas de HTML) ; "<" et ">" ne sont pas autorisés. "" l'efface.
^[^<>]*$participantsParticipants, texte libre. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.
^[^<>]*$colorCouleur d'affichage, par exemple "#2c7be5". "" l'efface.
^#?[A-Za-z0-9_-]{1,31}$Réponses
200
Mis à jour.
dataobligatoireChamps de data
id5501calendarL'agenda auquel appartient l'événement.
Champs de calendar
idId de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).
nametype"office" = l'agenda partagé du cabinet (tout utilisateur du cabinet peut le consulter et le modifier) ; "personal" = l'agenda propre d'un utilisateur, visible uniquement par son propriétaire et les personnes avec qui il est partagé.
"office" "personal" ownerPropriétaire d'un agenda personnel ; null pour l'agenda du cabinet.
Champs de owner
user_idnametitleTitre de l'événement. Texte brut.
descriptionDescription de l'événement. Texte brut.
locationLieu. Texte brut.
participantsParticipants, texte libre. Texte brut.
startÉvénement sur la journée entière : la date de début "YYYY-MM-DD". Événement horaire : ISO 8601 dans le fuseau horaire du cabinet (l'instant UTC stocké).
"2026-03-02T09:00:00+01:00"endMême encodage que start. Pour un événement sur la journée entière, la date de fin est INCLUSE (la valeur stockée, et non la valeur +1 jour utilisée par une grille d'agenda). Null lorsque l'événement n'a pas de fin.
all_dayTrue pour un événement sur la journée entière (start/end sont de simples dates) ; false pour un événement horaire (start/end sont des instants ISO 8601).
colorCouleur d'affichage, par exemple "#2c7be5".
is_recurringTrue lorsque l'événement est un maître récurrent. Les événements récurrents sont renvoyés une seule fois, NON développés en occurrences, et ne peuvent pas être modifiés via calendar.events.update.
recurrenceLa règle de récurrence d'un événement maître récurrent, ou null pour un événement unique. En lecture seule.
Champs de recurrence
freqdaily | weekly | monthly | yearly.
intervalbyweekdayCodes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").
untilcountcreated_byLe membre de l'équipe qui a créé l'événement.
Champs de created_by
user_idnamecreated_atupdated_atTransmettez cette valeur à calendar.events.update comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé l'enregistrement via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/calendar/events/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/calendar/events/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/calendar/events/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"title": "string"
}
Exemples de réponses
{
"data": {
"id": 5501,
"calendar": {
"id": 1234,
"name": "string",
"type": "office",
"owner": {
"user_id": 1234,
"name": "string"
}
},
"title": "string",
"description": "string",
"location": "string",
"participants": "string",
"start": "2026-03-02T09:00:00+01:00",
"end": "string",
"all_day": true,
"color": "string",
"is_recurring": true,
"recurrence": {
"freq": "string",
"interval": 0,
"byweekday": "string",
"until": "string",
"count": 0
},
"created_by": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Prise de rendez-vous
Lister les réservations
/api/agent/bookings
Liste les réservations de rendez-vous du cabinet (időpontfoglalások), des plus récentes aux plus anciennes. Filtrage facultatif par plage de jours from/to (fuseau horaire de réservation), par avocat (user_id), par statut ou par updated_since. Tout détenteur de clé voit les réservations de tous les avocats.
Paramètres de requête
fromUniquement les réservations à partir de ce jour inclus (YYYY-MM-DD), comparé littéralement à la date dans le fuseau de réservation.
"2026-01-01"toUniquement les réservations jusqu'à ce jour inclus (YYYY-MM-DD).
"2026-12-31"user_idFiltrer sur un seul avocat (user_id issu de colleagues.list). Omettez-le pour tous les avocats du cabinet.
statusFiltrer par statut.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" updated_sinceUniquement les réservations modifiées à partir de cet horodatage ISO 8601 inclus (updated_at est une heure locale du fuseau du cabinet, sans décalage).
limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/bookings?from=2026-01-01&to=2026-12-31&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/bookings?from=2026-01-01&to=2026-12-31&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/bookings?from=2026-01-01&to=2026-12-31&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"bookings:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"bookings:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "bookings:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir une réservation
/api/agent/bookings/{id}
Renvoie une réservation de rendez-vous avec l'avocat, les coordonnées du client, les instants de début/fin, l'état du paiement et le jeton de verrouillage updated_at pour bookings.update / .confirm / .cancel. Répond 404 lorsque la réservation n'existe pas dans ce cabinet.
Paramètres de chemin
idobligatoireId de la réservation.
4321Réponses
200
OK.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/bookings/4321' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/bookings/4321", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/bookings/4321",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "booking",
"record_id": 4321
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Créer une réservation
/api/agent/bookings
Books an appointment and emails the client the confirmation. Needs a free slot, else 409; source is "manual". Two-step: a call with no confirm_token returns confirmation_required + a preview + token; re-call with the token to proceed. An Idempotency-Key replay never re-books.
Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
user_idobligatoireAvocat avec qui le rendez-vous a lieu (user_id issu de colleagues.list ; doit être un membre actif de l'équipe du cabinet).
42dateobligatoireJour du rendez-vous (YYYY-MM-DD) dans le fuseau horaire de réservation.
"2026-03-02"timeobligatoireHeure de début HH:MM (24 h) dans le fuseau horaire de réservation. L'heure de fin est time + la durée de créneau du cabinet. Le créneau doit être libre.
^([01]\d|2[0-3]):[0-5]\d$"09:00"client_nameobligatoireNom du client. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$"Kovács Anna"client_emailobligatoireE-mail du client : destinataire de la confirmation.
"anna@example.com"client_phoneTéléphone du client. Texte brut.
^[^<>]*$client_descriptionObjet / notes du client. Texte brut.
^[^<>]*$location_preferenceConsultation au cabinet ou en ligne. Par défaut "office".
"office" "online" "office"meeting_linkURL de la réunion en ligne (http/https), pour une consultation en ligne.
gdpr_consentEnregistre le consentement du client au traitement de ses données. Par défaut true (l'équipe du cabinet réserve pour le compte du client).
trueauto_confirmSi true (ou si la confirmation automatique est activée pour le cabinet), crée la réservation directement confirmée : la synchronisation de l'agenda s'exécute et le client reçoit une confirmation au lieu d'une demande. Sinon, elle est pending.
falseconfirm_tokenTwo-step send confirmation. Leave empty on the first call; the action then returns "confirmation_required" with a preview and a confirm_token. To actually book and email the client, call again with the SAME arguments and this field set to that token.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/bookings' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"user_id": 42,
"date": "2026-03-02",
"time": "09:00",
"client_name": "Kovács Anna",
"client_email": "anna@example.com"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/bookings", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"user_id": 42,
"date": "2026-03-02",
"time": "09:00",
"client_name": "Kovács Anna",
"client_email": "anna@example.com"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/bookings",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"user_id": 42,
"date": "2026-03-02",
"time": "09:00",
"client_name": "Kovács Anna",
"client_email": "anna@example.com",
},
timeout=30,
)
print(response.status_code, response.json())
{
"user_id": 42,
"date": "2026-03-02",
"time": "09:00",
"client_name": "Kovács Anna",
"client_email": "anna@example.com"
}
Exemples de réponses
{
"data": {
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"user_id": [
"Le champ user id est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier une réservation
/api/agent/bookings/{id}
Reprogramme (date + time ensemble, avec nouvelle vérification de la disponibilité du créneau) ou modifie une réservation (téléphone, notes, lien de réunion, lieu). Seuls les champs envoyés sont écrits. Notifie l'avocat d'une reprogrammation, jamais le client. Transmettez expected_updated_at issu de votre dernière lecture ; une écriture obsolète répond 409.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
dateNouveau jour (YYYY-MM-DD) dans le fuseau horaire de réservation. Envoyez date ET time ensemble pour reprogrammer.
"2026-03-05"timeNouvelle heure de début HH:MM. L'heure de fin est recalculée à partir de la durée de créneau du cabinet. Envoyez date ET time ensemble.
^([01]\d|2[0-3]):[0-5]\d$"11:00"client_phoneTéléphone du client. Texte brut. "" l'efface.
^[^<>]*$client_descriptionObjet / notes. Texte brut. "" l'efface.
^[^<>]*$meeting_linkURL de la réunion en ligne (http/https). "" l'efface.
location_preferenceConsultation au cabinet ou en ligne.
"office" "online" Réponses
200
Mis à jour.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/bookings/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-05",
"time": "11:00"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/bookings/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-05",
"time": "11:00"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/bookings/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-05",
"time": "11:00",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"date": "2026-03-05",
"time": "11:00"
}
Exemples de réponses
{
"data": {
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Confirmer une réservation
/api/agent/bookings/{id}/confirm
Confirms a pending booking and emails the client (with the meeting link for online). Only pending, else 409. Two-step: a call with no confirm_token returns confirmation_required + a preview + token; re-call with the token to proceed. Optional expected_updated_at lock token.
Paramètres de chemin
idobligatoireId de la réservation.
4321Corps de la requête application/json
expected_updated_atJeton de verrouillage optimiste facultatif : l'updated_at de votre dernière lecture. Si la réservation a changé depuis, l'API répond 409 et vous relisez avant de réessayer.
meeting_linkURL de la réunion en ligne (http/https) à définir sur la réservation avant l'envoi de l'e-mail de confirmation.
confirm_tokenTwo-step send confirmation. Leave empty on the first call; the action then returns "confirmation_required" with a preview and a confirm_token. To actually confirm and email the client, call again with the SAME arguments and this field set to that token.
Réponses
200
OK.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/bookings/4321/confirm' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/bookings/4321/confirm", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00"
}),
});
const result = await response.json();
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/bookings/4321/confirm",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00"
}
Exemples de réponses
{
"data": {
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Annuler une réservation
/api/agent/bookings/{id}/cancel
Cancels a booking and emails the client and lawyer. Already cancelled/completed answers 409. A paid booking is never refunded. Two-step: a call with no confirm_token returns confirmation_required + a preview + token; re-call with the token to proceed. Optional expected_updated_at.
Paramètres de chemin
idobligatoireId de la réservation.
4321Corps de la requête application/json
expected_updated_atJeton de verrouillage optimiste facultatif : l'updated_at de votre dernière lecture. Si la réservation a changé depuis, l'API répond 409.
reasonMotif enregistré dans cancel_reason et affiché dans l'e-mail d'annulation. Texte brut ; "<" et ">" ne sont pas autorisés.
^[^<>]*$confirm_tokenTwo-step send confirmation. Leave empty on the first call; the action then returns "confirmation_required" with a preview and a confirm_token. To actually cancel and email the client, call again with the SAME arguments and this field set to that token.
Réponses
200
OK.
dataobligatoireChamps de data
id4321booking_numberNuméro de réservation lisible, par exemple "#B-0001".
statuspending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.
"pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired" sourceOrigine de la réservation. Une réservation créée par l'API vaut "manual".
"flowyer" "website" "embed_widget" "manual" lawyerL'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.
Champs de lawyer
user_idnamedateDate calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.
start_timeHeure de début HH:MM dans le fuseau horaire de réservation.
end_timeHeure de fin HH:MM dans le fuseau horaire de réservation.
startInstant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.
endInstant ISO 8601 non ambigu de la fin.
timezoneLe fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.
location_preferenceIndique si la consultation a lieu au cabinet ou en ligne.
"office" "online" meeting_linkURL de la réunion en ligne, si elle est définie.
clientLe client externe ayant réservé : nom, e-mail, téléphone et objet/notes. Données personnelles, réservées aux membres de l'équipe du cabinet.
Champs de client
nameemailphonedescriptiongdpr_consentIndique si le consentement du client au traitement de ses données est enregistré.
gdpr_consent_atDate d'enregistrement du consentement.
cancel_reasonMotif enregistré lors de l'annulation.
paymentÉtat du paiement, en lecture seule. L'API ne modifie jamais le paiement ; les frais de réservation sont gérés dans Flowyer.
Champs de payment
status"none" "awaiting" "partial" "paid" "refunded" method"card" "transfer" amountcurrencyinvoice_numberconfirmed_atcancelled_atcreated_atupdated_atTransmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.
created_via_apiPrésent lorsqu'un agent externe a créé la réservation via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduserat
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/bookings/4321/cancel' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/bookings/4321/cancel", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00"
}),
});
const result = await response.json();
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/bookings/4321/cancel",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00"
}
Exemples de réponses
{
"data": {
"id": 4321,
"booking_number": "string",
"status": "pending",
"source": "flowyer",
"lawyer": {
"user_id": 1234,
"name": "string"
},
"date": "2026-10-30",
"start_time": "string",
"end_time": "string",
"start": "2026-10-30T09:15:00+01:00",
"end": "2026-10-30T09:15:00+01:00",
"timezone": "string",
"location_preference": "office",
"meeting_link": "string",
"client": {
"name": "string",
"email": "info@example.hu",
"phone": "string",
"description": "string"
},
"gdpr_consent": true,
"gdpr_consent_at": "2026-10-30T09:15:00+01:00",
"cancel_reason": "string",
"payment": {
"status": "none",
"method": "card",
"amount": 0,
"currency": "string",
"invoice_number": "string"
},
"confirmed_at": "2026-10-30T09:15:00+01:00",
"cancelled_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Tickets
Lister les tickets
/api/agent/tickets
Liste les tickets de support que l'utilisateur peut voir (visibilité par boîte mail), de l'activité la plus récente à la plus ancienne. Filtrez par statut (par défaut open_states = new+open+pending ; "all" inclut les tickets fermés), boîte mail, responsable, e-mail du demandeur, ou texte libre sur l'objet/le demandeur/le numéro de ticket.
Paramètres de requête
statusopen_states (par défaut) = new+open+pending (la vue par défaut de l'interface web) ; "all" inclut les tickets fermés ; ou un statut exact.
"new" "open" "pending" "closed" "open_states" "all" "open_states"mailbox_idUniquement les tickets de cette boîte mail. Une boîte mail que l'utilisateur ne peut pas voir donne une liste vide (jamais de fuite).
7assigned_to_user_idUniquement les tickets attribués à ce membre de l'équipe (identifiant issu de colleagues.list) ; 0 = uniquement les tickets non attribués. Omettez-le pour tout responsable.
requester_emailUniquement les tickets dont l'e-mail du demandeur externe correspond exactement (sans distinction de casse).
"ugyfel@example.com"qRecherche en texte libre sur l'objet, le nom/l'e-mail du demandeur et le numéro de ticket (sans distinction de casse).
"számla"limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du ticket (à utiliser avec tickets.get / tickets.update).
4321ticket_numberNuméro de ticket lisible, par exemple FLW-000123.
subjectstatus"new" "open" "pending" "closed" priority"low" "normal" "high" mailboxLa boîte mail par laquelle le ticket est arrivé (registre central).
Champs de mailbox
idemaildisplay_namerequesterLa personne externe qui a écrit.
Champs de requester
emailnameassigned_toLe membre de l'équipe auquel le ticket est attribué, ou null s'il n'est pas attribué.
Champs de assigned_to
user_idnamematterLe dossier lié au ticket, ou null.
Champs de matter
idcase_numberclientLe client lié au ticket, ou null.
Champs de client
idnamelast_message_atHeure de la dernière activité du fil ; la liste est triée selon cette valeur, de la plus récente à la plus ancienne.
created_atupdated_atTransmettez cette valeur à tickets.update en tant que expected_updated_at.
created_via_apiPrésent lorsque le ticket a été créé via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/tickets?mailbox_id=7&requester_email=ugyfel%40example.com&q=sz%C3%A1mla' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/tickets?mailbox_id=7&requester_email=ugyfel%40example.com&q=sz%C3%A1mla", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/tickets?mailbox_id=7&requester_email=ugyfel%40example.com&q=sz%C3%A1mla",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 4321,
"ticket_number": "string",
"subject": "string",
"status": "new",
"priority": "low",
"mailbox": {
"id": 1234,
"email": "info@example.hu",
"display_name": "string"
},
"requester": {
"email": "info@example.hu",
"name": "string"
},
"assigned_to": {
"user_id": 1234,
"name": "string"
},
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"last_message_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"tickets:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"tickets:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "tickets:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Obtenir un ticket
/api/agent/tickets/{id}
Renvoie un ticket de support avec son fil de messages (des plus anciens aux plus récents) et le dossier/client lié. Répond 404 lorsque le ticket n'existe pas ou se trouve dans une boîte mail que l'utilisateur ne peut pas voir. La lecture ne modifie jamais le ticket (un ticket NEW ne passe pas à OPEN).
Paramètres de chemin
idobligatoireIdentifiant du ticket.
4321Paramètres de requête
messages_limitRenvoyer uniquement les N messages les plus récents du fil (toujours présentés des plus anciens aux plus récents). Omettez-le pour obtenir le fil complet.
Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du ticket (à utiliser avec tickets.get / tickets.update).
4321ticket_numberNuméro de ticket lisible, par exemple FLW-000123.
subjectstatus"new" "open" "pending" "closed" priority"low" "normal" "high" mailboxLa boîte mail par laquelle le ticket est arrivé (registre central).
Champs de mailbox
idemaildisplay_namerequesterLa personne externe qui a écrit.
Champs de requester
emailnameassigned_toLe membre de l'équipe auquel le ticket est attribué, ou null s'il n'est pas attribué.
Champs de assigned_to
user_idnamematterLe dossier lié au ticket, ou null.
Champs de matter
idcase_numberclientLe client lié au ticket, ou null.
Champs de client
idnamelast_message_atHeure de la dernière activité du fil ; la liste est triée selon cette valeur, de la plus récente à la plus ancienne.
created_atupdated_atTransmettez cette valeur à tickets.update en tant que expected_updated_at.
created_via_apiPrésent lorsque le ticket a été créé via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratmessagesLe fil de messages, des plus anciens aux plus récents.
Champs de messages
iddirectionin = du demandeur, out = réponse/accusé de réception automatique envoyé depuis la boîte mail, note = interne.
"in" "out" "note" fromChamps de from
emailnametoChamps de to
emailnameccChamps de cc
emailnamesent_statusÉtat de remise d'un message sortant ; null pour in/note.
"pending" "sent" "failed" "scheduled" body_textCorps du message en texte brut. Le corps HTML est volontairement omis pour que le fil reste compact ; lorsque le texte enregistré est vide, il est généré à partir du HTML.
has_attachmentsauthorLe membre de l'équipe qui a rédigé un message out/note ; null pour un message entrant.
Champs de author
user_idnamecreated_atlinked_matterLe dossier lié au ticket (identique à matter).
Champs de linked_matter
idcase_numberlinked_clientLe client lié au ticket (identique à client).
Champs de linked_client
idname
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/tickets/4321' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/tickets/4321", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/tickets/4321",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": {
"id": 4321,
"ticket_number": "string",
"subject": "string",
"status": "new",
"priority": "low",
"mailbox": {
"id": 1234,
"email": "info@example.hu",
"display_name": "string"
},
"requester": {
"email": "info@example.hu",
"name": "string"
},
"assigned_to": {
"user_id": 1234,
"name": "string"
},
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"last_message_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
},
"messages": [
{
"id": 1234,
"direction": "in",
"from": {
"email": "info@example.hu",
"name": "string"
},
"to": [
{
"email": "info@example.hu",
"name": "string"
}
],
"cc": [
{
"email": "info@example.hu",
"name": "string"
}
],
"sent_status": "pending",
"body_text": "string",
"has_attachments": true,
"author": {
"user_id": 1234,
"name": "string"
},
"created_at": "2026-10-30T09:15:00+01:00"
}
],
"linked_matter": {
"id": 1234,
"case_number": "string"
},
"linked_client": {
"id": 1234,
"name": "string"
}
}
}
{
"error": "not_found",
"message": "The record was not found, or it is not visible to the user who owns this API key.",
"message_localized": "L'enregistrement est introuvable ou n'est pas visible pour l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"record_type": "ticket",
"record_id": 4321
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Répondre à un ticket
/api/agent/tickets/{id}/reply
Replies to a support ticket and emails it to the external requester. Rich HTML, sanitised server-side. Two-step: a call with no confirm_token returns confirmation_required + a preview + token; re-call with the token to proceed. The same Idempotency-Key never resends.
Paramètres de chemin
idobligatoireIdentifiant du ticket (il doit être visible via l'ACL de la boîte mail).
4321Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
body_htmlobligatoireLa réponse, en HTML enrichi (tel que produit par TinyMCE). Nettoyée côté serveur par HTMLPurifier avant l'enregistrement et avant l'envoi. 100000 caractères au plus ; refusée si le nettoyage ne laisse rien.
"<p>Köszönjük megkeresését, csatoltan küldjük a választ.</p>"ccDestinataires Cc supplémentaires (10 au plus). Le demandeur et la boîte mail sont exclus automatiquement ; une adresse invalide renvoie 422.
statusStatut du ticket à définir après la réponse (par défaut "pending" = en attente du demandeur). Enregistre un événement de changement de statut.
"new" "open" "pending" "closed" "pending"append_signatureAjouter la signature de ticket enregistrée de l'utilisateur de la clé UNIQUEMENT à l'e-mail SORTANT (jamais enregistrée dans le fil).
falseconfirm_tokenTwo-step send confirmation. Leave empty on the first call; the action then returns "confirmation_required" with a preview and a confirm_token. To actually send, call again with the SAME arguments and this field set to that token.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
ticket_id4321message_idIdentifiant de la ligne ticket_messages sortante créée.
98765directionToujours "out".
sent_status"pending" au moment de la création ; l'envoi asynchrone le fait ensuite passer à sent/failed.
"pending" "sent" "failed" "scheduled" statusLe statut du ticket après la réponse.
"new" "open" "pending" "closed" created_atcreated_via_apiPrésent lorsque la réponse a été créée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
ticket_id4321message_idIdentifiant de la ligne ticket_messages sortante créée.
98765directionToujours "out".
sent_status"pending" au moment de la création ; l'envoi asynchrone le fait ensuite passer à sent/failed.
"pending" "sent" "failed" "scheduled" statusLe statut du ticket après la réponse.
"new" "open" "pending" "closed" created_atcreated_via_apiPrésent lorsque la réponse a été créée via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/tickets/4321/reply' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"body_html": "<p>Köszönjük megkeresését, csatoltan küldjük a választ.</p>"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/tickets/4321/reply", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"body_html": "<p>Köszönjük megkeresését, csatoltan küldjük a választ.</p>"
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/tickets/4321/reply",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"body_html": "<p>Köszönjük megkeresését, csatoltan küldjük a választ.</p>",
},
timeout=30,
)
print(response.status_code, response.json())
{
"body_html": "<p>Köszönjük megkeresését, csatoltan küldjük a választ.</p>"
}
Exemples de réponses
{
"data": {
"ticket_id": 4321,
"message_id": 98765,
"direction": "string",
"sent_status": "pending",
"status": "new",
"created_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": true
}
{
"data": {
"ticket_id": 4321,
"message_id": 98765,
"direction": "string",
"sent_status": "pending",
"status": "new",
"created_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"body_html": [
"Le champ body html est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Modifier le statut d'un ticket
/api/agent/tickets/{id}
Modifie le statut d'un ticket (new, open, pending ou closed). "closed" renseigne closed_at ; tout autre statut l'efface. Transmettez expected_updated_at issu de votre dernière lecture ; une modification concurrente renvoie 409. Répond 404 lorsque le ticket n'est pas visible.
Paramètres de chemin
idobligatoireId de l'enregistrement à modifier.
Corps de la requête application/json
expected_updated_atLa valeur updated_at issue de votre lecture la plus récente de cet enregistrement (obligatoire dès que l'enregistrement en possède une). Si l'enregistrement a changé depuis (un membre de l'équipe l'a modifié), l'API répond 409 et vous devez le relire avant de réessayer. Un enregistrement ancien dont updated_at est null prend null.
statusobligatoireLe nouveau statut. "closed" renseigne closed_at ; tout autre statut l'efface.
"new" "open" "pending" "closed" "open"Réponses
200
Mis à jour.
dataobligatoireChamps de data
idIdentifiant du ticket (à utiliser avec tickets.get / tickets.update).
4321ticket_numberNuméro de ticket lisible, par exemple FLW-000123.
subjectstatus"new" "open" "pending" "closed" priority"low" "normal" "high" mailboxLa boîte mail par laquelle le ticket est arrivé (registre central).
Champs de mailbox
idemaildisplay_namerequesterLa personne externe qui a écrit.
Champs de requester
emailnameassigned_toLe membre de l'équipe auquel le ticket est attribué, ou null s'il n'est pas attribué.
Champs de assigned_to
user_idnamematterLe dossier lié au ticket, ou null.
Champs de matter
idcase_numberclientLe client lié au ticket, ou null.
Champs de client
idnamelast_message_atHeure de la dernière activité du fil ; la liste est triée selon cette valeur, de la plus récente à la plus ancienne.
created_atupdated_atTransmettez cette valeur à tickets.update en tant que expected_updated_at.
created_via_apiPrésent lorsque le ticket a été créé via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratupdatedtrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'enregistrement a changé depuis votre lecture (record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
record_conflict : expected_updated_at ne correspond plus ; relisez-le et réessayez avec le nouvel updated_at).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X PATCH 'https://www.flowyer.fr/api/agent/tickets/1234' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-d '{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"status": "open"
}'
const response = await fetch("https://www.flowyer.fr/api/agent/tickets/1234", {
method: "PATCH",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"status": "open"
}),
});
const result = await response.json();
import requests
response = requests.patch(
"https://www.flowyer.fr/api/agent/tickets/1234",
headers={
"Authorization": "Bearer flw_...",
},
json={
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"status": "open",
},
timeout=30,
)
print(response.status_code, response.json())
{
"expected_updated_at": "2026-10-30T09:15:00+01:00",
"status": "open"
}
Exemples de réponses
{
"data": {
"id": 4321,
"ticket_number": "string",
"subject": "string",
"status": "new",
"priority": "low",
"mailbox": {
"id": 1234,
"email": "info@example.hu",
"display_name": "string"
},
"requester": {
"email": "info@example.hu",
"name": "string"
},
"assigned_to": {
"user_id": 1234,
"name": "string"
},
"matter": {
"id": 1234,
"case_number": "string"
},
"client": {
"id": 1234,
"name": "string"
},
"last_message_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00",
"updated_at": "2026-10-30T09:15:00+01:00",
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
},
"updated": true
}
{
"error": "record_conflict",
"message": "The record changed since you read it (someone edited it). Read it again and retry with the new updated_at.",
"message_localized": "L'enregistrement a été modifié depuis votre lecture (quelqu'un l'a modifié). Relisez-le et réessayez avec la nouvelle valeur updated_at.",
"locale": "fr",
"details": {
"current_updated_at": "2026-10-30T10:42:05+01:00",
"reason": "modified_since_read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Portail client
Lister les portails clients
/api/agent/portals
Liste les portails clients (fils de discussion) auxquels l'utilisateur peut accéder : le dossier, les participants côté client, le nombre de messages et de participants et l'heure du dernier message, des plus récents aux plus anciens. Filtrage facultatif sur un dossier (matter_id). Un dossier a au plus un portail.
Paramètres de requête
matter_idUniquement le portail de ce dossier (404 matter_not_visible lorsque le dossier n'est pas visible). Un dossier a au plus un portail.
1234limitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idIdentifiant du portail (fil) - la référence pour portal.messages.list et portal.reply.
57matterLe dossier auquel le portail appartient.
Champs de matter
idcase_numberclient_participantsLes participants externes côté client avec lesquels le cabinet échange.
Champs de client_participants
namekindclient = un mandant, contact = un contact du client, email = un ancien accès par e-mail uniquement.
"client" "contact" "email" participant_countNombre de participants actifs (équipe et client).
message_countNombre de messages non supprimés dans le fil.
last_message_atHeure de publication du message non supprimé le plus récent, ISO 8601 dans le fuseau du cabinet ; null pour un fil vide.
unread_for_meMessages non lus pour la ligne de participant propre à l'utilisateur agissant ; null lorsque l'utilisateur agissant n'est pas participant de ce portail.
created_atpaginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/portals?matter_id=1234&limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/portals?matter_id=1234&limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/portals?matter_id=1234&limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 57,
"matter": {
"id": 1234,
"case_number": "string"
},
"client_participants": [
{
"name": "string",
"kind": "client"
}
],
"participant_count": 0,
"message_count": 0,
"last_message_at": "2026-10-30T09:15:00+01:00",
"unread_for_me": 0,
"created_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "scope_missing",
"message": "This API key does not have the \"portal:read\" permission. The permissions of an existing key cannot be changed, so the key owner needs to create a new key with this permission in Flowyer under Integrations > AI assistants and use it in place of the old one.",
"message_localized": "Cette clé API ne dispose pas de l'autorisation \"portal:read\". Les autorisations d'une clé existante ne peuvent pas être modifiées : le titulaire de la clé doit donc créer une nouvelle clé disposant de cette autorisation dans Flowyer, sous Intégrations > Assistants IA, et l'utiliser à la place de l'ancienne.",
"locale": "fr",
"details": {
"required_scope": "portal:read"
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Lister les messages du portail
/api/agent/portals/{id}/messages
Liste les messages d'un fil du portail client, des plus anciens aux plus récents, avec l'auteur (équipe ou client), le corps en texte brut et les éventuelles métadonnées de pièce jointe. Répond 404 lorsque le portail n'existe pas ou n'est pas accessible. Ne marque pas les messages comme lus.
Paramètres de chemin
idobligatoireIdentifiant du portail (il doit être accessible).
57Paramètres de requête
include_deletedInclure les messages supprimés (leur corps est vidé). Valeur par défaut : false.
falselimitTaille de page, de 1 à 100. Par défaut : 25.
2525offsetNombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.
00Réponses
200
OK.
dataobligatoireChamps de data
idportal_messages.id.
8012authorAuteur du message.
Champs de author
participant_idnamekindstaff = un membre de l'équipe du cabinet, client = le client externe.
"staff" "client" directionfrom_firm = un auteur membre de l'équipe, from_client = le client externe.
"from_firm" "from_client" bodyLe message en texte brut (<br> converti en sauts de ligne). Chaîne vide pour un message supprimé.
attachmentMétadonnées de la pièce jointe lorsque le message comporte un document ; son téléchargement n'entre pas dans le périmètre. Null s'il n'y en a pas.
Champs de attachment
portal_document_idfile_nameis_deleteddeleted_atcreated_atHeure de publication du message, ISO 8601 dans le fuseau du cabinet.
paginationobligatoireChamps de pagination
limitobligatoireoffsetobligatoiretotalobligatoireNombre total d'enregistrements correspondants.
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl 'https://www.flowyer.fr/api/agent/portals/57/messages?limit=25' \
-H 'Authorization: Bearer flw_...'
const response = await fetch("https://www.flowyer.fr/api/agent/portals/57/messages?limit=25", {
headers: {
"Authorization": "Bearer flw_...",
},
});
const result = await response.json();
import requests
response = requests.get(
"https://www.flowyer.fr/api/agent/portals/57/messages?limit=25",
headers={
"Authorization": "Bearer flw_...",
},
timeout=30,
)
print(response.status_code, response.json())
Exemples de réponses
{
"data": [
{
"id": 8012,
"author": {
"participant_id": 1234,
"name": "string",
"kind": "staff"
},
"direction": "from_firm",
"body": "string",
"attachment": {
"portal_document_id": 1234,
"file_name": "string"
},
"is_deleted": true,
"deleted_at": "2026-10-30T09:15:00+01:00",
"created_at": "2026-10-30T09:15:00+01:00"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 1
}
}
{
"error": "portal_not_visible",
"message": "The client portal :id does not exist, or is not accessible to the user who owns this API key.",
"message_localized": "Le portail client :id n'existe pas ou n'est pas accessible à l'utilisateur titulaire de cette clé API.",
"locale": "fr",
"details": {
"portal_id": 57
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}
Répondre dans le portail client
/api/agent/portals/{id}/messages
Posts a staff reply in a client portal thread; the client sees it and gets an e-mail notice. Plain text, escaped on store. Two-step: a call with no confirm_token returns confirmation_required + a preview + token; re-call with the token to proceed. 404 if not accessible.
Paramètres de chemin
idobligatoireIdentifiant du portail dans lequel répondre (il doit être accessible).
57Paramètres d'en-tête
Idempotency-KeyRecommandé pour toute création. Une valeur unique par opération logique (par exemple un UUID). La même valeur renvoie le même enregistrement : une nouvelle tentative avec cette valeur renvoie l'enregistrement créé la première fois au lieu d'en créer un second. Des valeurs différentes créent toujours des enregistrements différents. Les clients qui ne peuvent pas envoyer d'en-têtes peuvent transmettre la même valeur dans le champ idempotency_key du corps. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$Corps de la requête application/json
bodyobligatoireLa réponse, en texte brut. Les chevrons sont acceptés et échappés à l'enregistrement. 20000 caractères au plus.
"Tisztelt Ügyfelünk! A beadványt ma benyújtottuk."confirm_tokenTwo-step send confirmation. Leave empty on the first call; the action then returns "confirmation_required" with a preview and a confirm_token. To actually post the reply and notify the client, call again with the SAME arguments and this field set to that token.
idempotency_keyMême rôle que l'en-tête Idempotency-Key, pour les clients qui ne peuvent pas envoyer d'en-têtes personnalisés. Lettres, chiffres, _, -, : ou ., 128 caractères au maximum.
^[A-Za-z0-9_\-:.]{1,128}$"b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"Réponses
201
Créé.
dataobligatoireChamps de data
messageLa réponse publiée.
Champs de message
id8012authorL'utilisateur de l'équipe agissant qui a publié la réponse.
Champs de author
participant_idnamekindstaff = un membre de l'équipe du cabinet, client = le client externe.
"staff" "client" directionToujours "from_firm" pour une réponse publiée via cette API.
"from_firm" "from_client" bodyLe message publié, en texte brut.
created_atportalLe portail (fil) et son dossier dans lesquels la réponse a été publiée.
Champs de portal
idmatterChamps de matter
idcase_numbercreated_via_apiProvenance du message créé via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedtrue
200
Rejeu idempotent : cette Idempotency-Key (ou, sans clé, une requête identique dans les 120 secondes) a déjà créé l'enregistrement ; il est renvoyé à nouveau, rien de nouveau n'a été créé.
dataobligatoireChamps de data
messageLa réponse publiée.
Champs de message
id8012authorL'utilisateur de l'équipe agissant qui a publié la réponse.
Champs de author
participant_idnamekindstaff = un membre de l'équipe du cabinet, client = le client externe.
"staff" "client" directionToujours "from_firm" pour une réponse publiée via cette API.
"from_firm" "from_client" bodyLe message publié, en texte brut.
created_atportalLe portail (fil) et son dossier dans lesquels la réponse a été publiée.
Champs de portal
idmatterChamps de matter
idcase_numbercreated_via_apiProvenance du message créé via cette API.
Champs de created_via_api
kind"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.
"key" "oauth" key_idId de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.
key_nameNom donné par l'utilisateur à la clé API, par exemple "Grok integration", ou nom de l'application connectée pour kind "oauth", par exemple "Claude".
user_iduseratcreatedfalseidempotent_replaytrue
400
Requête mal formée : corps JSON invalide, mauvais hôte (utilisez l'hôte www.) ou requête illisible.
401
La clé est absente, invalide, révoquée ou expirée, ou son utilisateur n'est plus actif.
403
Étendue manquante (scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
scope_missing), autorisation de module Flowyer manquante (module_forbidden), API désactivée pour le cabinet, licence expirée ou cabinet archivé.
404
Endpoint inconnu, ou l'enregistrement n'existe pas / n'est pas visible pour l'utilisateur. replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
replay_not_visible : cette Idempotency-Key (ou, sans clé, une requête identique) a déjà créé l'enregistrement (details.record_id), mais il a depuis été supprimé ou n'est pas visible pour l'utilisateur ; rien de nouveau n'a été créé, ne le recréez pas.
405
Méthode non proposée sur ce chemin (DELETE et PUT ne le sont jamais ; PATCH uniquement là où une mise à jour est proposée).
409
L'Idempotency-Key a été utilisée pour un autre type de ressource (idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
idempotency_key_reused) ou, sans clé, une requête identique est en cours de traitement (duplicate_in_progress ; réessayez dans un instant).
413
Le corps de la requête est trop volumineux (request_too_large).
request_too_large).
422
Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.
details.fields liste les erreurs par champ.
429
Limite de débit dépassée ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
503
Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; Retry-After indique quand réessayer.
Retry-After indique quand réessayer.
default
Toute autre erreur, dans la même enveloppe.
Exemples de requêtes
curl -X POST 'https://www.flowyer.fr/api/agent/portals/57/messages' \
-H 'Authorization: Bearer flw_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f3a9c21-1b2c-4d5e-8f90-0a1b2c3d4e5f' \
-d '{
"body": "Tisztelt Ügyfelünk! A beadványt ma benyújtottuk."
}'
const response = await fetch("https://www.flowyer.fr/api/agent/portals/57/messages", {
method: "POST",
headers: {
"Authorization": "Bearer flw_...",
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
"body": "Tisztelt Ügyfelünk! A beadványt ma benyújtottuk."
}),
});
const result = await response.json();
import uuid
import requests
response = requests.post(
"https://www.flowyer.fr/api/agent/portals/57/messages",
headers={
"Authorization": "Bearer flw_...",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"body": "Tisztelt Ügyfelünk! A beadványt ma benyújtottuk.",
},
timeout=30,
)
print(response.status_code, response.json())
{
"body": "Tisztelt Ügyfelünk! A beadványt ma benyújtottuk."
}
Exemples de réponses
{
"data": {
"message": {
"id": 8012,
"author": {
"participant_id": 1234,
"name": "string",
"kind": "staff"
},
"direction": "from_firm",
"body": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"portal": {
"id": 1234,
"matter": {
"id": 1234,
"case_number": "string"
}
},
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
},
"created": true
}
{
"data": {
"message": {
"id": 8012,
"author": {
"participant_id": 1234,
"name": "string",
"kind": "staff"
},
"direction": "from_firm",
"body": "string",
"created_at": "2026-10-30T09:15:00+01:00",
"portal": {
"id": 1234,
"matter": {
"id": 1234,
"case_number": "string"
}
},
"created_via_api": {
"kind": "key",
"key_id": 1234,
"key_name": "string",
"user_id": 1234,
"user": "string",
"at": "2026-10-30T09:15:00+01:00"
}
}
},
"created": false,
"idempotent_replay": true
}
{
"error": "validation_failed",
"message": "The request is invalid. See \"details.fields\" for the field-level errors.",
"message_localized": "La requête n'est pas valide. Consultez \"details.fields\" pour les erreurs par champ.",
"locale": "fr",
"details": {
"fields": {
"body": [
"Le champ body est obligatoire."
]
}
},
"request_id": "3f0c8a5e-2b1d-4c7a-9e6f-5a4b3c2d1e0f"
}