Flowyer API

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.

ÉtendueSignificationPoints 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.

HTTPerrorSignification
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

GET /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.

dataobligatoire
object
Champs de data
user
object
Champs de user
id
integer
name
string | null
language
string | null
office
object
Champs de office
id
integer
name
string | null
timezone
string

Fuseau IANA dans lequel l'API lit et écrit les horodatages, par exemple Europe/Budapest.

currency_id
integer

La devise du cabinet (identifiant de devise Flowyer) : costs.create comptabilise dans cette devise lorsque currency_id est omis.

currency
string | null

Code ISO de la devise du cabinet, par exemple HUF, EUR, RON.

key
object
Champs de key
id
integer
name
string

Nom que l'utilisateur a donné à cette clé, ou l'application connectée pour un jeton OAuth.

kind
string

"key" = une clé API statique, "oauth" = un jeton d'accès OAuth 2.1.

Valeurs autorisées: "key" "oauth"
prefix
string | null

Premiers caractères d'une clé statique, à des fins d'identification uniquement ; null pour OAuth.

expires_at
string <date-time> | null
last_used_at
string <date-time> | null
scopes
string[]

Étendues de cet identifiant d'accès, par exemple "matters:read". Une opération dont l'étendue manque répond 403.

available_scopes
string[]

Toutes les étendues que le titulaire de la clé pourrait activer dans Flowyer.

limits
object
Champs de limits
requests_per_minute
integer
list_max_limit
integer
channel
string

Comment la requête est parvenue à Flowyer.

Valeurs autorisées: "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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Équipe

Lister les membres de l'équipe

GET /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é.

Étendue
colleagues:read

Paramètres de requête

q
stringau maximum 255 caractères

Nom 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.

Exemple: "Nagy Péter"
limit
integer>= 1<= 500

Nombre maximal de membres de l'équipe à renvoyer (par défaut 200).

Par défaut: 200

Réponses

200

OK.

dataobligatoire
object
Champs de data
status
string | null

Uniquement 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.

Valeurs autorisées: "exact" "similar" "none"
colleagues
object[]

Membres actifs de l'équipe, meilleure correspondance en premier avec q, sinon par nom.

Champs de colleagues
id
integer

Id de l'utilisateur : transmettez-le comme assigned_to_user_id / responsible_user_id.

name
string

Nom affiché tel que Flowyer le présente (avec le titre, le cas échéant).

title
string | null

Titre précédant le nom, par exemple "Dr.", ou null.

total
integer

Nombre de membres de l'équipe correspondants (tous les membres actifs sans q) avant que la liste ne soit tronquée à limit.

truncated
boolean

True 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

Exemples de réponses

{
  "data": {
    "status": "exact",
    "colleagues": [
      {
        "id": 1234,
        "name": "string",
        "title": "string"
      }
    ],
    "total": 1,
    "truncated": true
  }
}

Dossiers

Lister les dossiers

GET /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.

Étendue
matters:read
Autorisation Flowyer
cases:read

Paramètres de requête

q
stringau maximum 100 caractères

Recherche 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".

Exemple: "2026/0025"
client_id
integer>= 1

Uniquement les dossiers de ce client.

Exemple: 512
responsible_user_id
integer>= 1

Uniquement 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_since
string <date-time>

Uniquement les dossiers modifiés à partir de cet instant (ISO 8601).

Exemple: "2026-10-01T00:00:00+02:00"
include_archived
boolean

Inclure les dossiers archivés.

Par défaut: false
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Identifiant du dossier. Utilisez-le ailleurs en tant que matter_id.

Exemple: 1234
case_number
string

Numéro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.

Exemple: "2026/0025"
subject
string
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
status
string
Valeurs autorisées: "active" "archived"
case_type_id
integer | null
case_type
string | null

Nom localisé du type de dossier.

responsible_user_id
integer | null
responsible
string | null

Nom affiché de l'avocat responsable.

clients
object[]

Clients (mandants) du dossier.

Champs de clients
id
integer
name
string
started_on
string <date> | null
restricted
boolean

True lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Lister les types de dossier

GET /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.

Étendue
matters:read

Ce point de terminaison n'accepte aucune donnée en entrée.

Réponses

200

OK.

dataobligatoire
object
Champs de data
case_types
object[]

Les types de dossier Flowyer, triés par nom.

Champs de case_types
id
integer

Identifiant du type de dossier : transmettez-le en tant que case_type_id à matters.create.

name
string

Nom du type de dossier (domaine du droit) dans la langue du cabinet.

total
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

Exemples de réponses

{
  "data": {
    "case_types": [
      {
        "id": 1234,
        "name": "string"
      }
    ],
    "total": 1
  }
}

Résoudre un dossier par son nom

GET /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.

Étendue
matters:read
Autorisation Flowyer
cases:read

Paramètres de requête

nameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Objet du dossier ou nom du client à rechercher, tel qu'entendu ou dicté.

Exemple: "ingatlan adásvétel"
client_id
integer | null>= 1

Uniquement les dossiers de ce client (à utiliser après que clients.resolve a renvoyé un client exact).

limit
integer>= 1<= 10

Nombre maximal de candidats à renvoyer (par défaut 5).

Par défaut: 5

Réponses

200

OK.

dataobligatoire
object
Champs de data
status
string

exact = 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.

Valeurs autorisées: "exact" "similar" "none"
matters
object[]

Dossiers candidats, meilleure correspondance en premier.

Champs de matters
id
integer

Identifiant du dossier. Utilisez-le ailleurs en tant que matter_id.

Exemple: 1234
case_number
string

Numéro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.

Exemple: "2026/0025"
subject
string
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
status
string
Valeurs autorisées: "active" "archived"
case_type_id
integer | null
case_type
string | null

Nom localisé du type de dossier.

responsible_user_id
integer | null
responsible
string | null

Nom affiché de l'avocat responsable.

clients
object[]

Clients (mandants) du dossier.

Champs de clients
id
integer
name
string
started_on
string <date> | null
restricted
boolean

True lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
total
integer

Nombre de dossiers correspondants avant que la liste ne soit tronquée à limit.

truncated
boolean

True 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un dossier

GET /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.

Étendue
matters:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer

Identifiant du dossier. Utilisez-le ailleurs en tant que matter_id.

Exemple: 1234
case_number
string

Numéro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.

Exemple: "2026/0025"
subject
string
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
status
string
Valeurs autorisées: "active" "archived"
case_type_id
integer | null
case_type
string | null

Nom localisé du type de dossier.

responsible_user_id
integer | null
responsible
string | null

Nom affiché de l'avocat responsable.

clients
object[]

Clients (mandants) du dossier.

Champs de clients
id
integer
name
string
started_on
string <date> | null
restricted
boolean

True lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
description
string | null
litigious
boolean
archived_at
string <date> | null

Jour 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Créer un dossier

POST /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.

Étendue
matters:create
Autorisation Flowyer
cases:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

subjectobligatoire
stringau moins 2 caractèresau maximum 255 caractères

Intitulé court du dossier tel qu'il apparaît dans les listes. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
case_type_idobligatoire
integer>= 1

Identifiant 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_idsobligatoire
integer[]au moins 1 élémentsau maximum 20 éléments

Identifiants des clients (mandants). Au moins un, au plus 20.

Exemple: [ 512 ]
responsible_user_id
integer | null>= 1

Avocat responsable : un identifiant d'utilisateur issu de colleagues.list (recherchez-y un nom dicté). Par défaut : l'utilisateur titulaire de la clé.

started_on
string <date> | null

Date de début, YYYY-MM-DD. Par défaut : aujourd'hui.

Exemple: "2026-10-29"
description
string | nullau maximum 10000 caractères

Description plus longue, texte brut.

main_case_number
string | nullau maximum 100 caractères

Numé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).

restricted
boolean

true = seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

Par défaut: false
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer

Identifiant du dossier. Utilisez-le ailleurs en tant que matter_id.

Exemple: 1234
case_number
string

Numéro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.

Exemple: "2026/0025"
subject
string
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
status
string
Valeurs autorisées: "active" "archived"
case_type_id
integer | null
case_type
string | null

Nom localisé du type de dossier.

responsible_user_id
integer | null
responsible
string | null

Nom affiché de l'avocat responsable.

clients
object[]

Clients (mandants) du dossier.

Champs de clients
id
integer
name
string
started_on
string <date> | null
restricted
boolean

True lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
description
string | null
litigious
boolean
archived_at
string <date> | null

Jour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer

Identifiant du dossier. Utilisez-le ailleurs en tant que matter_id.

Exemple: 1234
case_number
string

Numéro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.

Exemple: "2026/0025"
subject
string
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
status
string
Valeurs autorisées: "active" "archived"
case_type_id
integer | null
case_type
string | null

Nom localisé du type de dossier.

responsible_user_id
integer | null
responsible
string | null

Nom affiché de l'avocat responsable.

clients
object[]

Clients (mandants) du dossier.

Champs de clients
id
integer
name
string
started_on
string <date> | null
restricted
boolean

True lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
description
string | null
litigious
boolean
archived_at
string <date> | null

Jour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Mettre à jour un dossier

PATCH /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.

Étendue
matters:update
Autorisation Flowyer
cases:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

subject
string | nullau moins 1 caractères

Intitulé 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.

description
string | null

Description 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_on
string <date> | null

Date de début, YYYY-MM-DD. null conserve la valeur actuelle (une date de début ne peut pas être effacée).

litigious
boolean

Indique si le dossier est contentieux.

responsible_user_id
integer | null>= 0

Nouvel 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.

dataobligatoire
object
Champs de data
id
integer

Identifiant du dossier. Utilisez-le ailleurs en tant que matter_id.

Exemple: 1234
case_number
string

Numéro de dossier tel qu'affiché dans Flowyer, selon le schéma de numérotation du cabinet.

Exemple: "2026/0025"
subject
string
Exemple: "Kovács Kft. v. Nagy Bt. - contract dispute"
status
string
Valeurs autorisées: "active" "archived"
case_type_id
integer | null
case_type
string | null

Nom localisé du type de dossier.

responsible_user_id
integer | null
responsible
string | null

Nom affiché de l'avocat responsable.

clients
object[]

Clients (mandants) du dossier.

Champs de clients
id
integer
name
string
started_on
string <date> | null
restricted
boolean

True lorsque seuls les avocats responsables peuvent voir le dossier (muraille de Chine).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
description
string | null
litigious
boolean
archived_at
string <date> | null

Jour d'archivage du dossier, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Lister les responsables d'un dossier

GET /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.

Étendue
matters:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
type
string

"user" = un seul membre de l'équipe ; "workgroup" = tous les membres d'un groupe de travail.

Valeurs autorisées: "user" "workgroup"
user_id
integer | null

Identifiant 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_id
integer | null

Identifiant 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.

name
string | null

Nom affiché du membre de l'équipe ou du groupe de travail.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

Exemples de réponses

{
  "data": [
    {
      "type": "user",
      "user_id": 1234,
      "workgroup_id": 1234,
      "name": "string"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "total": 1
  }
}

Ajouter un responsable au dossier

POST /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.

Étendue
matters:update
Autorisation Flowyer
cases:modify

Paramètres de chemin

idobligatoire
integer>= 1

Dossier dont le membre de l'équipe devient responsable (il doit être visible).

Exemple: 1234

Corps de la requête application/json

user_idobligatoire
integer>= 1

Membre de l'équipe à ajouter : un identifiant d'utilisateur issu de colleagues.list. Son ajout lui donne accès au dossier.

Exemple: 42

Réponses

200

OK.

dataobligatoire
object
Champs de data
user_id
integer

Le membre de l'équipe désormais responsable du dossier.

name
string | null

Nom affiché du membre de l'équipe.

already_responsible
boolean

True lorsque le membre de l'équipe était déjà responsable du dossier (rien n'a changé).

notified
boolean

True 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é.

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).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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
}'

Exemples de réponses

{
  "data": {
    "user_id": 1234,
    "name": "string",
    "already_responsible": true,
    "notified": true
  }
}

Clients

Lister les clients

GET /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.

Étendue
clients:read
Autorisation Flowyer
contacts:read

Paramètres de requête

q
stringau maximum 100 caractères

Rechercher dans le nom (sans tenir compte des accents ni de la casse), l'e-mail et le numéro d'identification fiscale.

Exemple: "Kovács"
is_person
boolean

true = personnes physiques uniquement, false = sociétés uniquement.

include_archived
boolean
Par défaut: false
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Id du client. Utilisez-le comme client_id ailleurs.

Exemple: 512
name
string
Exemple: "Kovács Kft."
is_person
boolean

True pour une personne physique, false pour une société.

email
string | null
phone
string | null
archived
boolean
recorded_by_user_id
integer | null
recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Identifier un client par son nom

GET /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.

Étendue
clients:read
Autorisation Flowyer
contacts:read

Paramètres de requête

nameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Nom du client à rechercher, tel qu'entendu ou dicté.

Exemple: "Józsi ingatlan"
limit
integer>= 1<= 10

Nombre maximal de candidats à renvoyer (par défaut 5).

Par défaut: 5

Réponses

200

OK.

dataobligatoire
object
Champs de data
status
string

exact = 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.

Valeurs autorisées: "exact" "similar" "none"
matches
object[]

Clients candidats, meilleure correspondance en premier.

Champs de matches
id
integer

Id du client. Utilisez-le comme client_id ailleurs.

Exemple: 512
name
string
Exemple: "Kovács Kft."
is_person
boolean

True pour une personne physique, false pour une société.

email
string | null
phone
string | null
archived
boolean
recorded_by_user_id
integer | null
recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
total
integer

Nombre de clients correspondants avant que la liste ne soit tronquée à limit.

truncated
boolean

True 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un client

GET /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.

Étendue
clients:read
Autorisation Flowyer
contacts:read

Paramètres de chemin

idobligatoire
integer>= 1

Id du client.

Exemple: 512

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer

Id du client. Utilisez-le comme client_id ailleurs.

Exemple: 512
name
string
Exemple: "Kovács Kft."
is_person
boolean

True pour une personne physique, false pour une société.

email
string | null
phone
string | null
archived
boolean
recorded_by_user_id
integer | null
recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
address
object
Champs de address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
mailing_address
object
Champs de mailing_address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
tax_number
string | null

Sociétés uniquement ; null pour une personne physique.

company_registration_number
string | null

Sociétés uniquement ; null pour une personne physique.

representative_name
string | null

Sociétés uniquement ; null pour une personne physique.

representative_position
string | null

Sociétés uniquement ; null pour une personne physique.

main_activity
string | null

Activité principale. Sociétés uniquement ; null pour une personne physique.

nationality_country
string | null
note
string | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Créer un client

POST /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.

Étendue
clients:create
Autorisation Flowyer
contacts:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

nameobligatoire
stringau moins 2 caractèresau maximum 255 caractères

Nom complet de la personne ou dénomination de la société. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Kovács Kft."
is_person
boolean

true pour une personne physique, false (par défaut) pour une société.

Par défaut: false
email
string | nullau maximum 190 caractères
Exemple: "info@kovacskft.hu"
phone
string | nullau maximum 64 caractères
Exemple: "+36 1 234 5678"
address
object | null

Siège social / adresse du domicile.

Champs de address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
mailing_address
object | null
Champs de mailing_address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
tax_number
string | nullau maximum 64 caractères

Numéro d'identification fiscale de la société (sociétés uniquement).

Exemple: "12345678-2-41"
company_registration_number
string | nullau maximum 64 caractères

Numéro d'immatriculation de la société (sociétés uniquement).

Exemple: "01-09-123456"
representative_name
string | nullau maximum 255 caractères

Sociétés uniquement.

representative_position
string | nullau maximum 255 caractères

Sociétés uniquement.

main_activity
string | nullau maximum 255 caractères

Activité principale (sociétés uniquement).

nationality_country
string | nullau maximum 100 caractères
note
string | nullau maximum 4000 caractères
allow_duplicate_name
boolean

Créer même si un client actif portant le même nom existe.

Par défaut: false
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer

Id du client. Utilisez-le comme client_id ailleurs.

Exemple: 512
name
string
Exemple: "Kovács Kft."
is_person
boolean

True pour une personne physique, false pour une société.

email
string | null
phone
string | null
archived
boolean
recorded_by_user_id
integer | null
recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
address
object
Champs de address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
mailing_address
object
Champs de mailing_address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
tax_number
string | null

Sociétés uniquement ; null pour une personne physique.

company_registration_number
string | null

Sociétés uniquement ; null pour une personne physique.

representative_name
string | null

Sociétés uniquement ; null pour une personne physique.

representative_position
string | null

Sociétés uniquement ; null pour une personne physique.

main_activity
string | null

Activité principale. Sociétés uniquement ; null pour une personne physique.

nationality_country
string | null
note
string | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer

Id du client. Utilisez-le comme client_id ailleurs.

Exemple: 512
name
string
Exemple: "Kovács Kft."
is_person
boolean

True pour une personne physique, false pour une société.

email
string | null
phone
string | null
archived
boolean
recorded_by_user_id
integer | null
recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
address
object
Champs de address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
mailing_address
object
Champs de mailing_address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
tax_number
string | null

Sociétés uniquement ; null pour une personne physique.

company_registration_number
string | null

Sociétés uniquement ; null pour une personne physique.

representative_name
string | null

Sociétés uniquement ; null pour une personne physique.

representative_position
string | null

Sociétés uniquement ; null pour une personne physique.

main_activity
string | null

Activité principale. Sociétés uniquement ; null pour une personne physique.

nationality_country
string | null
note
string | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier un client

PATCH /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.

Étendue
clients:update
Autorisation Flowyer
contacts:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

name
string | nullau moins 1 caractères

Nom 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.

email
string | nullau maximum 190 caractères
phone
string | nullau maximum 64 caractères
address
object | null

Siège social / adresse du domicile.

Champs de address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
mailing_address
object | null
Champs de mailing_address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
representative_name
string | nullau maximum 255 caractères

Sociétés uniquement.

representative_position
string | nullau maximum 255 caractères

Sociétés uniquement.

main_activity
string | nullau maximum 255 caractères

Activité principale (sociétés uniquement).

nationality_country
string | nullau maximum 100 caractères
note
string | null

Note 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.

dataobligatoire
object
Champs de data
id
integer

Id du client. Utilisez-le comme client_id ailleurs.

Exemple: 512
name
string
Exemple: "Kovács Kft."
is_person
boolean

True pour une personne physique, false pour une société.

email
string | null
phone
string | null
archived
boolean
recorded_by_user_id
integer | null
recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
address
object
Champs de address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
mailing_address
object
Champs de mailing_address
zip
string | nullau maximum 20 caractères
city
string | nullau maximum 100 caractères
street
string | nullau maximum 255 caractères
tax_number
string | null

Sociétés uniquement ; null pour une personne physique.

company_registration_number
string | null

Sociétés uniquement ; null pour une personne physique.

representative_name
string | null

Sociétés uniquement ; null pour une personne physique.

representative_position
string | null

Sociétés uniquement ; null pour une personne physique.

main_activity
string | null

Activité principale. Sociétés uniquement ; null pour une personne physique.

nationality_country
string | null
note
string | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Contacts

Lister les contacts

GET /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.

Étendue
contacts:read
Autorisation Flowyer
contacts:read

Paramètres de requête

client_id
integer>= 1

Filtrer sur les contacts d'un seul client.

Exemple: 512
q
stringau maximum 100 caractères

Rechercher dans le nom, l'e-mail et le téléphone.

Exemple: "Anna"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Id du contact.

Exemple: 734
name
string
Exemple: "Dr. Kovács Anna"
organization
string | null

Organisation / company, if recorded.

position
string | null

Role or position, if recorded.

Exemple: "ügyvezető"
note
string | null
date
string | null

Legacy free date field. Read-only.

emails
object[]

All e-mail addresses (structured, multi-value).

Champs de emails
email
string
type
string | null
is_primary
boolean
phones
object[]

All phone numbers (structured, multi-value).

Champs de phones
phone
string
type
string | null
is_primary
boolean
addresses
object[]

All postal addresses (structured, multi-value).

Champs de addresses
formatted
string | null
postal_code
string | null
city
string | null
street
string | null
country
string | null
type
string | null
is_primary
boolean
client_ids
integer[]

Ids of the clients this contact is linked to.

matter_ids
integer[]

Ids of the matters this contact is linked to.

client_id
integer | null

Primary/first client id (compat; see client_ids[]).

Exemple: 512
email
string | null

Primary e-mail (compat; see emails[]).

phone
string | null

Primary phone (compat; see phones[]).

address
string | null

Primary address (compat; see addresses[]).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un contact

GET /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.

Étendue
contacts:read
Autorisation Flowyer
contacts:read

Paramètres de chemin

idobligatoire
integer>= 1

Id du contact (issu de contacts.list ou matters.contacts).

Exemple: 734

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer

Id du contact.

Exemple: 734
name
string
Exemple: "Dr. Kovács Anna"
organization
string | null

Organisation / company, if recorded.

position
string | null

Role or position, if recorded.

Exemple: "ügyvezető"
note
string | null
date
string | null

Legacy free date field. Read-only.

emails
object[]

All e-mail addresses (structured, multi-value).

Champs de emails
email
string
type
string | null
is_primary
boolean
phones
object[]

All phone numbers (structured, multi-value).

Champs de phones
phone
string
type
string | null
is_primary
boolean
addresses
object[]

All postal addresses (structured, multi-value).

Champs de addresses
formatted
string | null
postal_code
string | null
city
string | null
street
string | null
country
string | null
type
string | null
is_primary
boolean
client_ids
integer[]

Ids of the clients this contact is linked to.

matter_ids
integer[]

Ids of the matters this contact is linked to.

client_id
integer | null

Primary/first client id (compat; see client_ids[]).

Exemple: 512
email
string | null

Primary e-mail (compat; see emails[]).

phone
string | null

Primary phone (compat; see phones[]).

address
string | null

Primary address (compat; see addresses[]).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Créer un contact

POST /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.

Étendue
contacts:create
Autorisation Flowyer
contacts:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

nameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Nom de la personne de contact. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Dr. Kovács Anna"
organization
string | nullau maximum 255 caractères

Organisation / société.

position
string | nullau maximum 255 caractères

Rôle ou fonction.

Exemple: "ügyvezető"
emails
string[] | nullau maximum 20 éléments

Adresses e-mail ; la première est la principale. À privilégier par rapport au champ unique email.

Exemple: [ "anna@kovacskft.hu" ]
email
string | nullau maximum 190 caractères

Ancien e-mail unique (compatibilité ; privilégiez emails[]).

Exemple: "anna@kovacskft.hu"
phones
string[] | nullau maximum 20 éléments

Numéros de téléphone ; le premier est le principal. À privilégier par rapport au champ unique phone.

Exemple: [ "+36 1 234 5678" ]
phone
string | nullau maximum 64 caractères

Ancien téléphone unique (compatibilité ; privilégiez phones[]).

Exemple: "+36 1 234 5678"
addresses
string[] | nullau maximum 20 éléments

Adresses postales (texte libre) ; la première est la principale. À privilégier par rapport au champ unique address.

address
string | nullau maximum 2000 caractères

Ancienne adresse unique (compatibilité ; privilégiez addresses[]).

note
string | nullau maximum 4000 caractères
client_ids
integer[] | nullau maximum 50 éléments

Identifiants des clients (mandants) auxquels rattacher le contact. Nombre quelconque, ou aucun. À privilégier par rapport au champ unique client_id.

Exemple: [ 512 ]
client_id
integer | null>= 1

Ancien client unique à rattacher (compatibilité ; privilégiez client_ids[]).

Exemple: 512
matter_ids
integer[] | nullau maximum 50 éléments

Identifiants 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.

Exemple: [ 1234 ]
matter_id
integer | null>= 1

Ancien dossier unique à rattacher (compatibilité ; privilégiez matter_ids[]).

Exemple: 1234
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer

Id du contact.

Exemple: 734
name
string
Exemple: "Dr. Kovács Anna"
organization
string | null

Organisation / company, if recorded.

position
string | null

Role or position, if recorded.

Exemple: "ügyvezető"
note
string | null
date
string | null

Legacy free date field. Read-only.

emails
object[]

All e-mail addresses (structured, multi-value).

Champs de emails
email
string
type
string | null
is_primary
boolean
phones
object[]

All phone numbers (structured, multi-value).

Champs de phones
phone
string
type
string | null
is_primary
boolean
addresses
object[]

All postal addresses (structured, multi-value).

Champs de addresses
formatted
string | null
postal_code
string | null
city
string | null
street
string | null
country
string | null
type
string | null
is_primary
boolean
client_ids
integer[]

Ids of the clients this contact is linked to.

matter_ids
integer[]

Ids of the matters this contact is linked to.

client_id
integer | null

Primary/first client id (compat; see client_ids[]).

Exemple: 512
email
string | null

Primary e-mail (compat; see emails[]).

phone
string | null

Primary phone (compat; see phones[]).

address
string | null

Primary address (compat; see addresses[]).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer

Id du contact.

Exemple: 734
name
string
Exemple: "Dr. Kovács Anna"
organization
string | null

Organisation / company, if recorded.

position
string | null

Role or position, if recorded.

Exemple: "ügyvezető"
note
string | null
date
string | null

Legacy free date field. Read-only.

emails
object[]

All e-mail addresses (structured, multi-value).

Champs de emails
email
string
type
string | null
is_primary
boolean
phones
object[]

All phone numbers (structured, multi-value).

Champs de phones
phone
string
type
string | null
is_primary
boolean
addresses
object[]

All postal addresses (structured, multi-value).

Champs de addresses
formatted
string | null
postal_code
string | null
city
string | null
street
string | null
country
string | null
type
string | null
is_primary
boolean
client_ids
integer[]

Ids of the clients this contact is linked to.

matter_ids
integer[]

Ids of the matters this contact is linked to.

client_id
integer | null

Primary/first client id (compat; see client_ids[]).

Exemple: 512
email
string | null

Primary e-mail (compat; see emails[]).

phone
string | null

Primary phone (compat; see phones[]).

address
string | null

Primary address (compat; see addresses[]).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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
}'

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
}

Modifier un contact

PATCH /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.

Étendue
contacts:update
Autorisation Flowyer
contacts:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

name
string | nullau moins 1 caractèresau maximum 255 caractères

Nom de la personne de contact. "<" et ">" ne peuvent pas être introduits ; null conserve le nom actuel.

Motif: ^[^<>]*$
organization
string | nullau maximum 255 caractères

Organisation / société. null l'efface.

position
string | nullau maximum 255 caractères

Rôle ou fonction. null l'efface.

emails
string[] | nullau maximum 20 éléments

Remplace 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).

email
string | nullau maximum 190 caractères

E-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.

phones
string[] | nullau maximum 20 éléments

Remplace 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.

phone
string | nullau maximum 64 caractères

Téléphone principal (compatibilité ; privilégiez phones[]). null efface tous les téléphones.

addresses
string[] | nullau maximum 20 éléments

Remplace TOUTES les adresses postales (texte libre) ; la première est la principale. À privilégier par rapport à address. Un tableau vide efface toutes les adresses.

address
string | nullau maximum 2000 caractères

Adresse (principale) en texte libre (compatibilité ; privilégiez addresses[]). null efface toutes les adresses.

note
string | nullau maximum 4000 caractères

Note en texte libre. null l'efface.

client_ids
integer[] | nullau maximum 50 éléments

Remplace TOUS les liens avec les clients (mandants). Un tableau vide détache tous les clients. Omettez-le pour ne pas modifier les liens.

matter_ids
integer[] | nullau maximum 50 éléments

Remplace 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_token
string

Confirmation 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.

dataobligatoire
object
Champs de data
id
integer

Id du contact.

Exemple: 734
name
string
Exemple: "Dr. Kovács Anna"
organization
string | null

Organisation / company, if recorded.

position
string | null

Role or position, if recorded.

Exemple: "ügyvezető"
note
string | null
date
string | null

Legacy free date field. Read-only.

emails
object[]

All e-mail addresses (structured, multi-value).

Champs de emails
email
string
type
string | null
is_primary
boolean
phones
object[]

All phone numbers (structured, multi-value).

Champs de phones
phone
string
type
string | null
is_primary
boolean
addresses
object[]

All postal addresses (structured, multi-value).

Champs de addresses
formatted
string | null
postal_code
string | null
city
string | null
street
string | null
country
string | null
type
string | null
is_primary
boolean
client_ids
integer[]

Ids of the clients this contact is linked to.

matter_ids
integer[]

Ids of the matters this contact is linked to.

client_id
integer | null

Primary/first client id (compat; see client_ids[]).

Exemple: 512
email
string | null

Primary e-mail (compat; see emails[]).

phone
string | null

Primary phone (compat; see phones[]).

address
string | null

Primary address (compat; see addresses[]).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Lister les contacts d'un dossier

GET /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.

Étendue
contacts:read
Autorisation Flowyer
contacts:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

q
stringau maximum 100 caractères

Rechercher dans le nom, l'e-mail et le téléphone.

Exemple: "Anna"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Id du contact.

Exemple: 734
name
string
Exemple: "Dr. Kovács Anna"
organization
string | null

Organisation / company, if recorded.

position
string | null

Role or position, if recorded.

Exemple: "ügyvezető"
note
string | null
date
string | null

Legacy free date field. Read-only.

emails
object[]

All e-mail addresses (structured, multi-value).

Champs de emails
email
string
type
string | null
is_primary
boolean
phones
object[]

All phone numbers (structured, multi-value).

Champs de phones
phone
string
type
string | null
is_primary
boolean
addresses
object[]

All postal addresses (structured, multi-value).

Champs de addresses
formatted
string | null
postal_code
string | null
city
string | null
street
string | null
country
string | null
type
string | null
is_primary
boolean
client_ids
integer[]

Ids of the clients this contact is linked to.

matter_ids
integer[]

Ids of the matters this contact is linked to.

client_id
integer | null

Primary/first client id (compat; see client_ids[]).

Exemple: 512
email
string | null

Primary e-mail (compat; see emails[]).

phone
string | null

Primary phone (compat; see phones[]).

address
string | null

Primary address (compat; see addresses[]).

created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Tâches

Lister les tâches

GET /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.

Étendue
tasks:read
Autorisation Flowyer
tasks:read

Paramètres de requête

status
string

open (par défaut), closed ou all.

Valeurs autorisées: "open" "closed" "all"
Par défaut: "open"
assigned_to_user_id
integer>= 1

Uniquement les tâches attribuées à cet utilisateur (un identifiant d'utilisateur issu de colleagues.list).

matter_id
integer>= 1

Uniquement les tâches de ce dossier.

client_id
integer>= 1

Uniquement les tâches hors dossier de ce client.

deadline_from
string <date>

Échéance à cette date ou après.

Exemple: "2026-11-01"
deadline_to
string <date>

Échéance à cette date ou avant.

Exemple: "2026-11-30"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 9876
subject
string
Exemple: "Submit the statement of defence"
description
string | null
deadline
string <date> | null

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
priority
integer | null

1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).

Exemple: 2
status
string
Valeurs autorisées: "open" "closed"
closed_at
string <date> | null

Jour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

matter
object | null

Le dossier auquel la tâche appartient, le cas échéant.

Champs de matter
id
integer
case_number
string
client
object | null

Le client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.

Champs de client
id
integer
name
string
assigned_to_user_id
integer | null
assigned_to
string | null
created_by_user_id
integer | null
created_by
string | null
flag_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une tâche

GET /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.

Étendue
tasks:read
Autorisation Flowyer
tasks:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant de la tâche.

Exemple: 9876

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
subject
string
Exemple: "Submit the statement of defence"
description
string | null
deadline
string <date> | null

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
priority
integer | null

1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).

Exemple: 2
status
string
Valeurs autorisées: "open" "closed"
closed_at
string <date> | null

Jour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

matter
object | null

Le dossier auquel la tâche appartient, le cas échéant.

Champs de matter
id
integer
case_number
string
client
object | null

Le client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.

Champs de client
id
integer
name
string
assigned_to_user_id
integer | null
assigned_to
string | null
created_by_user_id
integer | null
created_by
string | null
flag_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Créer une tâche

POST /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.

Étendue
tasks:create
Autorisation Flowyer
tasks:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

subjectobligatoire
stringau moins 2 caractèresau maximum 1000 caractères

Ce qui doit être fait. Texte brut.

Exemple: "Submit the statement of defence"
deadlineobligatoire
string <date>

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
matter_id
integer | null>= 1

Dossier auquel la tâche appartient. Omettez-le pour une tâche hors dossier.

Exemple: 1234
client_id
integer | null>= 1

Client 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_id
integer | null>= 1

Membre 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é.

priority
integer>= 1<= 3

1 = basse, 2 = moyenne (par défaut), 3 = haute.

Par défaut: 2
description
string | nullau maximum 10000 caractères

Détails plus longs, texte brut.

flag_id
integer | null>= 1

Identifiant d'un marqueur de tâche du cabinet (étiquette).

idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
subject
string
Exemple: "Submit the statement of defence"
description
string | null
deadline
string <date> | null

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
priority
integer | null

1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).

Exemple: 2
status
string
Valeurs autorisées: "open" "closed"
closed_at
string <date> | null

Jour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

matter
object | null

Le dossier auquel la tâche appartient, le cas échéant.

Champs de matter
id
integer
case_number
string
client
object | null

Le client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.

Champs de client
id
integer
name
string
assigned_to_user_id
integer | null
assigned_to
string | null
created_by_user_id
integer | null
created_by
string | null
flag_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
subject
string
Exemple: "Submit the statement of defence"
description
string | null
deadline
string <date> | null

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
priority
integer | null

1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).

Exemple: 2
status
string
Valeurs autorisées: "open" "closed"
closed_at
string <date> | null

Jour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

matter
object | null

Le dossier auquel la tâche appartient, le cas échéant.

Champs de matter
id
integer
case_number
string
client
object | null

Le client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.

Champs de client
id
integer
name
string
assigned_to_user_id
integer | null
assigned_to
string | null
created_by_user_id
integer | null
created_by
string | null
flag_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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
}'

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
}

Modifier une tâche

PATCH /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.

Étendue
tasks:update
Autorisation Flowyer
tasks:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

subject
string | nullau moins 1 caractères

Ce 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
string <date> | null

Échéance, YYYY-MM-DD. null conserve l'échéance actuelle (une échéance ne peut pas être effacée).

matter_id
integer | null>= 1

Dé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_id
integer | null>= 1

Client d'une tâche hors dossier. Autorisé uniquement lorsque la tâche n'a pas de dossier.

assigned_to_user_id
integer | null>= 0

Nouveau 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.

priority
integer>= 1<= 3

1 = 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é.

description
string | null

Dé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_id
integer | null>= 1

Identifiant d'un marqueur de tâche du cabinet (étiquette), ou null pour le retirer.

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
subject
string
Exemple: "Submit the statement of defence"
description
string | null
deadline
string <date> | null

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
priority
integer | null

1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).

Exemple: 2
status
string
Valeurs autorisées: "open" "closed"
closed_at
string <date> | null

Jour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

matter
object | null

Le dossier auquel la tâche appartient, le cas échéant.

Champs de matter
id
integer
case_number
string
client
object | null

Le client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.

Champs de client
id
integer
name
string
assigned_to_user_id
integer | null
assigned_to
string | null
created_by_user_id
integer | null
created_by
string | null
flag_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Clôturer une tâche

POST /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.

Étendue
tasks:update
Autorisation Flowyer
tasks:modify

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant de la tâche.

Exemple: 9876

Corps de la requête application/json

minutes_spent
integer | null>= 0<= 100000

Temps passé, en minutes. Toute saisie de temps nécessite l'étendue workhours:create et un dossier.

minutes_invoiceable
integer | null>= 0<= 100000

Minutes facturables ; plafonnées au plafond horaire du cabinet.

minutes_normative
integer | null>= 0<= 100000

Minutes normatives ; enregistrées telles quelles, jamais plafonnées.

matter_id
integer | null>= 1

Rattacher 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_id
integer | null>= 1

Client direct (Megbízó) pour une tâche hors dossier clôturée sans dossier.

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
subject
string
Exemple: "Submit the statement of defence"
description
string | null
deadline
string <date> | null

Échéance, YYYY-MM-DD.

Exemple: "2026-11-15"
priority
integer | null

1 = basse, 2 = moyenne, 3 = haute ; null = non renseignée (une tâche ancienne sans priorité).

Exemple: 2
status
string
Valeurs autorisées: "open" "closed"
closed_at
string <date> | null

Jour de clôture de la tâche, YYYY-MM-DD. Flowyer n'enregistre que la date, sans l'heure.

matter
object | null

Le dossier auquel la tâche appartient, le cas échéant.

Champs de matter
id
integer
case_number
string
client
object | null

Le client : le premier client du dossier, ou le client propre à la tâche lorsqu'elle n'a pas de dossier.

Champs de client
id
integer
name
string
assigned_to_user_id
integer | null
assigned_to
string | null
created_by_user_id
integer | null
created_by
string | null
flag_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created_via_api
object | null
Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
booked_workhour
object | null

La saisie de temps enregistrée lors de la clôture, ou null si aucun temps n'a été indiqué.

Champs de booked_workhour
id
integer>= 1
minutes
integer
minutes_invoiceable
integer
minutes_normative
integer
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é.

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).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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 '{}'

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
    }
  }
}

Temps passés

Lister les saisies de temps

GET /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.

Étendue
workhours:read
Autorisation Flowyer
workhours:read

Paramètres de requête

matter_id
integer>= 1

Uniquement les saisies de ce dossier.

Exemple: 1234
responsible_user_id
integer>= 1

Uniquement les saisies imputées à ce membre de l'équipe (un identifiant d'utilisateur issu de colleagues.list).

date_from
string <date>

Uniquement les saisies à cette date ou après (YYYY-MM-DD).

date_to
string <date>

Uniquement les saisies à cette date ou avant (YYYY-MM-DD).

external_id
stringau maximum 64 caractères

Uniquement 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.

status
string

Saisies à 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".

Valeurs autorisées: "live" "invoiced" "all"
Par défaut: "live"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer | null

Identifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier sur lequel la saisie est imputée.

date
string <date> | null
activity
string | null

Ce qui a été fait (texte brut).

minutes
integer | null

Minutes passées.

minutes_invoiceable
integer | null

Minutes 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_normative
integer | null

Minutes normatives (à titre indicatif ; jamais plafonnées).

responsible_user_id
integer | null

Membre de l'équipe auquel le temps est imputé.

responsible
string | null
recorded_by_user_id
integer | null

Auteur de l'enregistrement de la saisie.

locked
boolean

True lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).

excluded
boolean

True 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_id
string | null

Un 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation de la saisie (uniquement pour une saisie facturée).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une saisie de temps

GET /api/agent/workhours/{id}

Renvoie une saisie de temps active par son identifiant, si son dossier est visible pour l'utilisateur.

Étendue
workhours:read
Autorisation Flowyer
workhours:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant de la saisie de temps.

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier sur lequel la saisie est imputée.

date
string <date> | null
activity
string | null

Ce qui a été fait (texte brut).

minutes
integer | null

Minutes passées.

minutes_invoiceable
integer | null

Minutes 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_normative
integer | null

Minutes normatives (à titre indicatif ; jamais plafonnées).

responsible_user_id
integer | null

Membre de l'équipe auquel le temps est imputé.

responsible
string | null
recorded_by_user_id
integer | null

Auteur de l'enregistrement de la saisie.

locked
boolean

True lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).

excluded
boolean

True 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_id
string | null

Un 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation de la saisie (uniquement pour une saisie facturée).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Enregistrer une saisie de temps

POST /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é.

Étendue
workhours:create
Autorisation Flowyer
workhours:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

matter_idobligatoire
integer>= 1

Dossier sur lequel le temps est imputé (il doit être visible).

Exemple: 1234
dateobligatoire
string <date>

Date du travail, YYYY-MM-DD.

Exemple: "2026-10-30"
subject
stringau moins 2 caractèresau maximum 1000 caractères

Ce 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.

Motif: ^[^<>]*$
Exemple: "Drafting the statement of claim"
activity
stringau moins 2 caractèresau maximum 1000 caractères

Le même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux.

Motif: ^[^<>]*$
minutes
integer | null>= 0<= 100000

Minutes réellement passées.

Exemple: 90
minutes_invoiceable
integer | null>= 0<= 100000

Minutes 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.

Exemple: 60
minutes_normative
integer | null>= 0<= 100000

Minutes normatives (à titre indicatif ; jamais plafonnées).

responsible_user_id
integer | null>= 1

Membre 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_id
string | nullau maximum 64 caractères

Un 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.

Motif: ^[A-Za-z0-9_.:-]{1,64}$
Exemple: "65a1f3c9e4b0a2d1f8c7b6a5"
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier sur lequel la saisie est imputée.

date
string <date> | null
activity
string | null

Ce qui a été fait (texte brut).

minutes
integer | null

Minutes passées.

minutes_invoiceable
integer | null

Minutes 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_normative
integer | null

Minutes normatives (à titre indicatif ; jamais plafonnées).

responsible_user_id
integer | null

Membre de l'équipe auquel le temps est imputé.

responsible
string | null
recorded_by_user_id
integer | null

Auteur de l'enregistrement de la saisie.

locked
boolean

True lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).

excluded
boolean

True 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_id
string | null

Un 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation de la saisie (uniquement pour une saisie facturée).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.

created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier sur lequel la saisie est imputée.

date
string <date> | null
activity
string | null

Ce qui a été fait (texte brut).

minutes
integer | null

Minutes passées.

minutes_invoiceable
integer | null

Minutes 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_normative
integer | null

Minutes normatives (à titre indicatif ; jamais plafonnées).

responsible_user_id
integer | null

Membre de l'équipe auquel le temps est imputé.

responsible
string | null
recorded_by_user_id
integer | null

Auteur de l'enregistrement de la saisie.

locked
boolean

True lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).

excluded
boolean

True 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_id
string | null

Un 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation de la saisie (uniquement pour une saisie facturée).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.

created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier une saisie de temps

PATCH /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.

Étendue
workhours:update
Autorisation Flowyer
workhours:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

date
string <date> | null

Date du travail, YYYY-MM-DD. null conserve la date actuelle.

subject
string | nullau moins 1 caractères

Ce 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.

activity
string | nullau moins 1 caractères

Le même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux (null sous l'autre est accepté).

minutes
integer | null>= 0<= 100000

Minutes réellement passées ; null les efface.

minutes_invoiceable
integer | null>= 0<= 100000

Minutes 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_normative
integer | null>= 0<= 100000

Minutes normatives (jamais plafonnées) ; null les efface.

responsible_user_id
integer | null>= 0

Nouveau 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.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant de la saisie de temps ; null pour une saisie facturée (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier sur lequel la saisie est imputée.

date
string <date> | null
activity
string | null

Ce qui a été fait (texte brut).

minutes
integer | null

Minutes passées.

minutes_invoiceable
integer | null

Minutes 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_normative
integer | null

Minutes normatives (à titre indicatif ; jamais plafonnées).

responsible_user_id
integer | null

Membre de l'équipe auquel le temps est imputé.

responsible
string | null
recorded_by_user_id
integer | null

Auteur de l'enregistrement de la saisie.

locked
boolean

True lorsque la saisie est en lecture seule via l'API (une saisie facturée est toujours verrouillée).

excluded
boolean

True 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_id
string | null

Un 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation de la saisie (uniquement pour une saisie facturée).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour une saisie facturée.

updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Frais

Lister les frais

GET /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.

Étendue
costs:read
Autorisation Flowyer
cases:read, summary:read

Paramètres de requête

matter_id
integer>= 1

Uniquement les frais de ce dossier.

Exemple: 1234
responsible_user_id
integer>= 1

Uniquement les frais enregistrés pour ce membre de l'équipe (un id utilisateur issu de colleagues.list).

date_from
string <date>

Uniquement les frais datés de ce jour ou après (YYYY-MM-DD).

date_to
string <date>

Uniquement les frais datés de ce jour ou avant (YYYY-MM-DD).

status
string

Frais à 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".

Valeurs autorisées: "live" "invoiced" "all"
Par défaut: "live"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer | null

Identifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier auquel appartiennent les frais.

date
string <date> | null
activity
string | null

Description des frais (texte brut).

cost
number | null

Montant HT des frais (hors TVA).

cost_invoiceable
number | null

Montant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.

currency_id
integer | null

Id de la devise (liste des devises de Flowyer).

currency
string | null

Code ISO de la devise, par exemple HUF, EUR.

responsible_user_id
integer | null
responsible
string | null
excluded
boolean

True 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.

locked
boolean

True 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_billing
boolean

True 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation du frais (uniquement pour un frais facturé).

invoice_id
integer | null

La facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une ligne de frais

GET /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.

Étendue
costs:read
Autorisation Flowyer
cases:read, summary:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de la ligne de frais.

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier auquel appartiennent les frais.

date
string <date> | null
activity
string | null

Description des frais (texte brut).

cost
number | null

Montant HT des frais (hors TVA).

cost_invoiceable
number | null

Montant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.

currency_id
integer | null

Id de la devise (liste des devises de Flowyer).

currency
string | null

Code ISO de la devise, par exemple HUF, EUR.

responsible_user_id
integer | null
responsible
string | null
excluded
boolean

True 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.

locked
boolean

True 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_billing
boolean

True 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation du frais (uniquement pour un frais facturé).

invoice_id
integer | null

La facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Enregistrer des frais

POST /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é.

Étendue
costs:create
Autorisation Flowyer
cases:create, summary:read

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

matter_idobligatoire
integer>= 1

Dossier auquel appartiennent les frais (doit être visible).

Exemple: 1234
dateobligatoire
string <date>

Date des frais, YYYY-MM-DD.

Exemple: "2026-10-30"
subject
stringau moins 2 caractèresau maximum 1000 caractères

Description 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.

Motif: ^[^<>]*$
Exemple: "Court filing fee"
activity
stringau moins 2 caractèresau maximum 1000 caractères

Le même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux.

Motif: ^[^<>]*$
costobligatoire
integer>= 0<= 2147483647

Montant HT des frais (hors TVA), nombre entier dans l'unité principale de la devise (les centimes ne sont pas stockés).

Exemple: 15000
cost_invoiceable
integer | null>= 0<= 2147483647

Montant 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.

Exemple: 15000
currency_id
integer | null>= 1

Id 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_id
integer | null>= 1

Membre 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_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier auquel appartiennent les frais.

date
string <date> | null
activity
string | null

Description des frais (texte brut).

cost
number | null

Montant HT des frais (hors TVA).

cost_invoiceable
number | null

Montant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.

currency_id
integer | null

Id de la devise (liste des devises de Flowyer).

currency
string | null

Code ISO de la devise, par exemple HUF, EUR.

responsible_user_id
integer | null
responsible
string | null
excluded
boolean

True 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.

locked
boolean

True 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_billing
boolean

True 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation du frais (uniquement pour un frais facturé).

invoice_id
integer | null

La facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.

created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier auquel appartiennent les frais.

date
string <date> | null
activity
string | null

Description des frais (texte brut).

cost
number | null

Montant HT des frais (hors TVA).

cost_invoiceable
number | null

Montant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.

currency_id
integer | null

Id de la devise (liste des devises de Flowyer).

currency
string | null

Code ISO de la devise, par exemple HUF, EUR.

responsible_user_id
integer | null
responsible
string | null
excluded
boolean

True 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.

locked
boolean

True 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_billing
boolean

True 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation du frais (uniquement pour un frais facturé).

invoice_id
integer | null

La facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.

created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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
}'

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
}

Modifier une ligne de frais

PATCH /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.

Étendue
costs:update
Autorisation Flowyer
cases:modify, summary:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

date
string <date> | null

Date des frais, YYYY-MM-DD. null conserve la date actuelle.

subject
string | nullau moins 1 caractères

Description 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.

activity
string | nullau moins 1 caractères

Le même champ que subject, sous le nom utilisé en lecture. Envoyez l'un des deux (null sous l'autre est accepté).

cost
integer | null>= 0<= 2147483647

Montant 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_invoiceable
integer | null>= 0<= 2147483647

Montant 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_id
integer | null>= 0

Id 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_id
integer | null>= 0

Nouveau 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.

dataobligatoire
object
Champs de data
id
integer | null

Identifiant du frais ; null pour un frais facturé (lecture seule, sans identifiant modifiable).

matter_id
integer | null

Dossier auquel appartiennent les frais.

date
string <date> | null
activity
string | null

Description des frais (texte brut).

cost
number | null

Montant HT des frais (hors TVA).

cost_invoiceable
number | null

Montant HT à refacturer au client. Il n'est pris en compte dans la facturation que tant que excluded vaut false.

currency_id
integer | null

Id de la devise (liste des devises de Flowyer).

currency
string | null

Code ISO de la devise, par exemple HUF, EUR.

responsible_user_id
integer | null
responsible
string | null
excluded
boolean

True 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.

locked
boolean

True 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_billing
boolean

True 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.

invoiced
boolean

True 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_at
string <date-time> | null

Date de facturation du frais (uniquement pour un frais facturé).

invoice_id
integer | null

La facture sur laquelle ce frais a été facturé, si elle est connue (uniquement pour un frais facturé).

created_at
string <date-time> | null
updated_at
string <date-time> | null

Renvoyez cette valeur en tant que expected_updated_at lors d'une mise à jour. Null pour un frais facturé.

updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Factures

Lister les factures

GET /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.

Étendue
invoices:read
Autorisation Flowyer
invoices:read, summary:read

Paramètres de requête

direction
string

Les 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.

Valeurs autorisées: "incoming" "outgoing" "proforma"
paid_status
string
Valeurs autorisées: "unpaid" "paid" "partially_paid" "cancelled"
client_id
integer>= 1
matter_id
integer>= 1
issued_from
string <date>

Date d'émission à partir de ce jour inclus.

Exemple: "2026-01-01"
issued_to
string <date>

Date d'émission jusqu'à ce jour inclus.

Exemple: "2026-12-31"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 301
invoice_number
string | null
Exemple: "FLW-2026-0042"
direction
string | null

outgoing = émise par le cabinet, incoming = reçue par le cabinet.

Valeurs autorisées: "incoming" "outgoing"
document_type
string | null

"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.

Valeurs autorisées: "invoice" "proforma" "receipt"
source
string | null
Valeurs autorisées: "manual" "szamlazz_outgoing" "szamlazz_imported"
paid_status
string | null
Valeurs autorisées: "unpaid" "paid" "partially_paid" "cancelled"
issued_date
string <date> | null
due_date
string <date> | null
paid_date
string <date> | null
completion_date
string <date> | null
net_amount
number | null
gross_amount
number | null
currency
string | null
Exemple: "HUF"
payment_method_id
integer | null
payment_method
string | null

Nom 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
string | null

Émetteur d'une facture reçue.

client
object | null
Champs de client
id
integer
name
string
matter_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une facture

GET /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.

Étendue
invoices:read
Autorisation Flowyer
invoices:read, summary:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de la facture.

Exemple: 301

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 301
invoice_number
string | null
Exemple: "FLW-2026-0042"
direction
string | null

outgoing = émise par le cabinet, incoming = reçue par le cabinet.

Valeurs autorisées: "incoming" "outgoing"
document_type
string | null

"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.

Valeurs autorisées: "invoice" "proforma" "receipt"
source
string | null
Valeurs autorisées: "manual" "szamlazz_outgoing" "szamlazz_imported"
paid_status
string | null
Valeurs autorisées: "unpaid" "paid" "partially_paid" "cancelled"
issued_date
string <date> | null
due_date
string <date> | null
paid_date
string <date> | null
completion_date
string <date> | null
net_amount
number | null
gross_amount
number | null
currency
string | null
Exemple: "HUF"
payment_method_id
integer | null
payment_method
string | null

Nom 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
string | null

Émetteur d'une facture reçue.

client
object | null
Champs de client
id
integer
name
string
matter_id
integer | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
notes
string | null
received_date
string <date> | null
sent_date
string <date> | null
proforma_invoice_id
integer | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Documents

Lister les documents d'un dossier

GET /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.

Étendue
documents:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

q
stringau maximum 100 caractères

Filtrer par nom de fichier.

Exemple: "contract"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
name
string

Nom 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.

Exemple: "Contract_v2.docx"
size
integer | null

Octets.

version
integer

Numéro de version actuel du fichier.

folder
object | null

Le 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
id
integer
name
string
path
string

Chemin du répertoire dans le dossier, séparé par "/".

folder_deleted
boolean

True 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_id
integer | null
created_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Lister les répertoires d'un dossier

GET /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.

Étendue
documents:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

q
stringau maximum 100 caractères

Uniquement 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.

Exemple: "Beadványok"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Identifiant du répertoire : transmettez-le en tant que folder_id à documents.upload.init.

name
string

Nom du répertoire tel qu'affiché dans Flowyer.

parent_id
integer | null

Id du répertoire parent ; null pour un répertoire à la racine du dossier.

path
string

Chemin 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_at
string <date-time> | null

Transmettez cette valeur à documents.folders.rename comme expected_updated_at.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Créer un répertoire de dossier

POST /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.

Étendue
documents:create
Autorisation Flowyer
cases:create

Paramètres de chemin

idobligatoire
integer>= 1

Dossier auquel le répertoire appartient (il doit être visible).

Exemple: 1234

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

nameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Nom du répertoire, 255 caractères au plus. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Beadványok"
parent_id
integer | null>= 1

Identifiant 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_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer

Id du répertoire : transmettez-le comme folder_id à documents.upload.init, ou comme parent_id à documents.folders.create.

name
string

Nom du répertoire tel qu'affiché dans Flowyer.

parent_id
integer | null

Id du répertoire parent ; null pour un répertoire à la racine du dossier.

path
string

Chemin du répertoire dans le dossier, séparé par "/", par exemple "/Iratok/Beadványok".

updated_at
string <date-time> | null

Transmettez cette valeur à documents.folders.rename comme expected_updated_at.

created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer

Id du répertoire : transmettez-le comme folder_id à documents.upload.init, ou comme parent_id à documents.folders.create.

name
string

Nom du répertoire tel qu'affiché dans Flowyer.

parent_id
integer | null

Id du répertoire parent ; null pour un répertoire à la racine du dossier.

path
string

Chemin du répertoire dans le dossier, séparé par "/", par exemple "/Iratok/Beadványok".

updated_at
string <date-time> | null

Transmettez cette valeur à documents.folders.rename comme expected_updated_at.

created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Démarrer l'import d'un document

POST /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.

Étendue
documents:create
Autorisation Flowyer
cases:create

Paramètres de chemin

idobligatoire
integer>= 1

Dossier auquel le document appartient (il doit être visible).

Corps de la requête application/json

filenameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Nom 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).

Motif: ^[^<>]*$
Exemple: "Contract.pdf"
content_typeobligatoire
stringau moins 1 caractèresau maximum 100 caractères

Type MIME envoyé lors du PUT, par exemple "application/pdf". Il fait partie de la signature et doit correspondre exactement.

Exemple: "application/pdf"
sizeobligatoire
integer>= 1

Taille du fichier en octets, 104857600 au plus (la limite d'import) ; une taille supérieure renvoie 413 file_too_large.

Exemple: 248000
folder_id
integer | null>= 1

Ré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.

dataobligatoire
object
Champs de data
upload_url
string

URL 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_token
string

Transmettez cette valeur à documents.upload.complete une fois le PUT réussi.

content_type
string

Envoyez exactement ce Content-Type lors du PUT.

if_generation_match
string

Envoyez 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_key
string

Nom de stockage interne (pour information).

expires_in
integer

Secondes 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é.

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).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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
}'

Exemples de réponses

{
  "data": {
    "upload_url": "string",
    "upload_token": "string",
    "content_type": "string",
    "if_generation_match": "string",
    "object_key": "string",
    "expires_in": 0
  }
}

Terminer l'import d'un document

POST /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.

Étendue
documents:create
Autorisation Flowyer
cases:create

Paramètres de chemin

idobligatoire
integer>= 1

Dossier auquel le document appartient (le même que lors de l'init).

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

upload_tokenobligatoire
stringau moins 1 caractèresau maximum 4096 caractères

Le jeton renvoyé par documents.upload.init.

idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
name
string

Nom 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.

Exemple: "Contract_v2.docx"
size
integer | null

Octets.

version
integer

Numéro de version actuel du fichier.

folder
object | null

Le 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
id
integer
name
string
path
string

Chemin du répertoire dans le dossier, séparé par "/".

folder_deleted
boolean

True 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_id
integer | null
created_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created
boolean
Valeur: true
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é.

dataobligatoire
object
Champs de data
id
integer
name
string

Nom 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.

Exemple: "Contract_v2.docx"
size
integer | null

Octets.

version
integer

Numéro de version actuel du fichier.

folder
object | null

Le 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
id
integer
name
string
path
string

Chemin du répertoire dans le dossier, séparé par "/".

folder_deleted
boolean

True 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_id
integer | null
created_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

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).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Télécharger un document

GET /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.

Étendue
documents:download
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Id du document (issu de documents.list).

Réponses

200

OK.

dataobligatoire
object
Champs de data
download_url
string

URL signée. Effectuez un GET dessus pour télécharger les octets du fichier.

filename
string

Nom du fichier pour le téléchargement.

size
integer | null

Octets.

expires_in
integer

Secondes 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

Exemples de réponses

{
  "data": {
    "download_url": "string",
    "filename": "string",
    "size": 0,
    "expires_in": 0
  }
}

Lister les versions d'un document

GET /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.

Étendue
documents:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Id du document : n'importe laquelle de ses versions (issu de documents.list ou documents.versions).

Exemple: 1234

Paramètres de requête

limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Id de version : transmettez-le à documents.download (étendue documents:download) pour récupérer les octets de cette version précise.

version
integer

Numéro de version ; le plus élevé correspond à la version actuelle.

is_current
boolean

True pour la version que Flowyer affiche actuellement, false pour une version antérieure remplacée.

name
string

Nom de fichier stocké avec cette version (son nom de stockage lorsqu'elle a été importée sans nom).

size
integer | null

Octets.

uploaded_by_user_id
integer | null
uploaded_by
string | null
uploaded_at
string <date-time> | null

Date de classement de cette version.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Renommer un document

PATCH /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.

Étendue
documents:update
Autorisation Flowyer
cases:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

nameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Nouveau 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.

Motif: ^[^<>]*$
Exemple: "Contract_signed.pdf"

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer
name
string

Nom 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.

Exemple: "Contract_v2.docx"
size
integer | null

Octets.

version
integer

Numéro de version actuel du fichier.

folder
object | null

Le 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
id
integer
name
string
path
string

Chemin du répertoire dans le dossier, séparé par "/".

folder_deleted
boolean

True 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_id
integer | null
created_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Renommer un répertoire du dossier

PATCH /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.

Étendue
documents:update
Autorisation Flowyer
cases:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

nameobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Nouveau nom du répertoire, 255 caractères au maximum. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Beadványok"

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer

Id du répertoire : transmettez-le comme folder_id à documents.upload.init, ou comme parent_id à documents.folders.create.

name
string

Nom du répertoire tel qu'affiché dans Flowyer.

parent_id
integer | null

Id du répertoire parent ; null pour un répertoire à la racine du dossier.

path
string

Chemin du répertoire dans le dossier, séparé par "/", par exemple "/Iratok/Beadványok".

updated_at
string <date-time> | null

Transmettez cette valeur à documents.folders.rename comme expected_updated_at.

updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Base de connaissances

Lister les articles de la base de connaissances

GET /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.

Étendue
knowledge:read

Paramètres de requête

q
string | nullau maximum 255 caractères

Terme de recherche en texte intégral (titres, extraits, contenu et noms d'étiquettes). Les opérateurs booléens sont supprimés.

Exemple: "felmondási idő"
status
string | null

Uniquement les articles ayant ce statut. Omettez-le pour lister tous les statuts.

Valeurs autorisées: "draft" "published" "archived"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 9876
slug
string

Slug d'URL généré par le serveur.

Exemple: "felmondasi-ido"
title
string
Exemple: "Felmondási idő a munka törvénykönyvében"
excerpt
string | null

Résumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.

status
string
Valeurs autorisées: "draft" "published" "archived"
is_featured
boolean

Indique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).

category_id
integer | null
category_name
string | null
author_id
integer

Id utilisateur de l'auteur ; 0 pour un article global (par défaut).

author_name
string | null
editor_id
integer | null

Id utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.

editor_name
string | null
views_count
integer
downloads_count
integer
shared_roles
integer[]

Id des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).

tags
string[]

Noms des étiquettes de l'article.

published_at
string <date-time> | null

Date de première publication de l'article, ou null.

created_at
string <date-time> | null
updated_at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un article de la base de connaissances

GET /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.

Étendue
knowledge:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'article.

Exemple: 9876

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
slug
string

Slug d'URL généré par le serveur.

Exemple: "felmondasi-ido"
title
string
Exemple: "Felmondási idő a munka törvénykönyvében"
excerpt
string | null

Résumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.

status
string
Valeurs autorisées: "draft" "published" "archived"
is_featured
boolean

Indique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).

category_id
integer | null
category_name
string | null
author_id
integer

Id utilisateur de l'auteur ; 0 pour un article global (par défaut).

author_name
string | null
editor_id
integer | null

Id utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.

editor_name
string | null
views_count
integer
downloads_count
integer
shared_roles
integer[]

Id des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).

tags
string[]

Noms des étiquettes de l'article.

published_at
string <date-time> | null

Date de première publication de l'article, ou null.

created_at
string <date-time> | null
updated_at
string <date-time> | null
content
string

Le 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Créer un article de la base de connaissances

POST /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.

Étendue
knowledge:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

titleobligatoire
stringau maximum 500 caractères

Titre de l'article. Texte brut.

Exemple: "Felmondási idő a munka törvénykönyvében"
excerpt
string | null

Résumé court (HTML autorisé, nettoyé côté serveur), 200 caractères au maximum.

contentobligatoire
string

Le corps de l'article. HTML enrichi, nettoyé côté serveur selon le profil de la base de connaissances.

category_idobligatoire
integer>= 1

Id d'une catégorie existante et active de la base de connaissances.

Exemple: 12
statusobligatoire
string

draft, published ou archived. published renseigne published_at.

Valeurs autorisées: "draft" "published" "archived"
tags
string[] | null

Noms des étiquettes ; les nouvelles étiquettes sont créées si nécessaire.

shared_roles
integer[] | null

Id des rôles avec lesquels partager l'article. Vide signifie que seul l'auteur peut le voir.

idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
slug
string

Slug d'URL généré par le serveur.

Exemple: "felmondasi-ido"
title
string
Exemple: "Felmondási idő a munka törvénykönyvében"
excerpt
string | null

Résumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.

status
string
Valeurs autorisées: "draft" "published" "archived"
is_featured
boolean

Indique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).

category_id
integer | null
category_name
string | null
author_id
integer

Id utilisateur de l'auteur ; 0 pour un article global (par défaut).

author_name
string | null
editor_id
integer | null

Id utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.

editor_name
string | null
views_count
integer
downloads_count
integer
shared_roles
integer[]

Id des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).

tags
string[]

Noms des étiquettes de l'article.

published_at
string <date-time> | null

Date de première publication de l'article, ou null.

created_at
string <date-time> | null
updated_at
string <date-time> | null
content
string

Le corps complet de l'article tel qu'enregistré (HTML enrichi).

created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
slug
string

Slug d'URL généré par le serveur.

Exemple: "felmondasi-ido"
title
string
Exemple: "Felmondási idő a munka törvénykönyvében"
excerpt
string | null

Résumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.

status
string
Valeurs autorisées: "draft" "published" "archived"
is_featured
boolean

Indique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).

category_id
integer | null
category_name
string | null
author_id
integer

Id utilisateur de l'auteur ; 0 pour un article global (par défaut).

author_name
string | null
editor_id
integer | null

Id utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.

editor_name
string | null
views_count
integer
downloads_count
integer
shared_roles
integer[]

Id des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).

tags
string[]

Noms des étiquettes de l'article.

published_at
string <date-time> | null

Date de première publication de l'article, ou null.

created_at
string <date-time> | null
updated_at
string <date-time> | null
content
string

Le corps complet de l'article tel qu'enregistré (HTML enrichi).

created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier un article de la base de connaissances

PATCH /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.

Étendue
knowledge:update

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

title
string | null

Titre de l'article (texte brut). null conserve le titre actuel ; un nouveau titre entraîne le recalcul du slug.

excerpt
string | null

Résumé court (HTML autorisé, nettoyé), 200 caractères au maximum pour une NOUVELLE valeur. Vide/null l'efface ; omettez-le pour le conserver.

content
string | null

Le corps de l'article (HTML enrichi, nettoyé). null conserve le contenu actuel ; il ne peut pas être effacé.

category_id
integer | null>= 1

Déplace l'article vers cette catégorie existante et active. null conserve la catégorie actuelle.

status
string | null

draft, published ou archived. Le premier passage à published renseigne published_at ; cette valeur n'est jamais effacée. null conserve le statut actuel.

Valeurs autorisées: "draft" "published" "archived"
tags
string[] | null

Remplace l'ensemble des étiquettes (les nouvelles étiquettes sont créées). Un tableau vide efface toutes les étiquettes ; omettez-le pour les conserver.

shared_roles
integer[] | null

Remplace 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.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
slug
string

Slug d'URL généré par le serveur.

Exemple: "felmondasi-ido"
title
string
Exemple: "Felmondási idő a munka törvénykönyvében"
excerpt
string | null

Résumé court (HTML enrichi, tel qu'enregistré). Utilisez knowledge.articles.get pour obtenir le corps complet.

status
string
Valeurs autorisées: "draft" "published" "archived"
is_featured
boolean

Indique si l'article est épinglé sur la page d'accueil de la base de connaissances (non modifiable via l'API).

category_id
integer | null
category_name
string | null
author_id
integer

Id utilisateur de l'auteur ; 0 pour un article global (par défaut).

author_name
string | null
editor_id
integer | null

Id utilisateur du dernier rédacteur, ou null s'il n'a jamais été modifié.

editor_name
string | null
views_count
integer
downloads_count
integer
shared_roles
integer[]

Id des rôles avec lesquels l'article est partagé (vide = uniquement l'auteur/global).

tags
string[]

Noms des étiquettes de l'article.

published_at
string <date-time> | null

Date de première publication de l'article, ou null.

created_at
string <date-time> | null
updated_at
string <date-time> | null
content
string

Le corps complet de l'article tel qu'enregistré (HTML enrichi).

updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Lister les catégories de la base de connaissances

GET /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).

Étendue
knowledge:read

Paramètres de requête

limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 42
slug
string

Slug d'URL, généré à partir du nom.

Exemple: "munkajog"
name
string
Exemple: "Munkajog"
description
string | null

Description en texte brut, ou null.

icon
string | null

Identifiant de l'icône affichée à côté de la catégorie, ou null.

order_column
integer

Position de tri parmi les catégories de même niveau.

Exemple: 0
is_active
boolean
parent_id
integer | null

Id de la catégorie parente, ou null pour une catégorie racine.

author_id
integer

Id utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.

author_name
string | null

Nom affiché du créateur, ou null pour une catégorie par défaut.

articles_count
integer

Nombre d'articles publiés de cette catégorie que l'appelant peut voir.

shared_roles
integer[]

Id 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_at
string <date-time> | null
updated_at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une catégorie de la base de connaissances

GET /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.

Étendue
knowledge:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de la catégorie.

Exemple: 42

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 42
slug
string

Slug d'URL, généré à partir du nom.

Exemple: "munkajog"
name
string
Exemple: "Munkajog"
description
string | null

Description en texte brut, ou null.

icon
string | null

Identifiant de l'icône affichée à côté de la catégorie, ou null.

order_column
integer

Position de tri parmi les catégories de même niveau.

Exemple: 0
is_active
boolean
parent_id
integer | null

Id de la catégorie parente, ou null pour une catégorie racine.

author_id
integer

Id utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.

author_name
string | null

Nom affiché du créateur, ou null pour une catégorie par défaut.

articles_count
integer

Nombre d'articles publiés de cette catégorie que l'appelant peut voir.

shared_roles
integer[]

Id 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_at
string <date-time> | null
updated_at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Créer une catégorie de la base de connaissances

POST /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.

Étendue
knowledge:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

nameobligatoire
stringau maximum 255 caractères

Nom de la catégorie. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Munkajog"
description
string | null

Description facultative, en texte brut.

parent_id
integer | null>= 1

Id de la catégorie parente (doit exister et être active). Omettez-le pour une catégorie racine.

icon
string | nullau maximum 100 caractères

Identifiant d'icône facultatif. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
is_active
boolean | null

Indique si la catégorie est active. Par défaut true.

Par défaut: true
order_column
integer | null>= 0

Position de tri parmi les catégories de même niveau. Par défaut 0.

Exemple: 0
shared_roles
integer[] | null

Id des rôles avec lesquels partager cette catégorie. Omettez-le pour que vous seul (l'auteur) puissiez la voir.

idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 42
slug
string

Slug d'URL, généré à partir du nom.

Exemple: "munkajog"
name
string
Exemple: "Munkajog"
description
string | null

Description en texte brut, ou null.

icon
string | null

Identifiant de l'icône affichée à côté de la catégorie, ou null.

order_column
integer

Position de tri parmi les catégories de même niveau.

Exemple: 0
is_active
boolean
parent_id
integer | null

Id de la catégorie parente, ou null pour une catégorie racine.

author_id
integer

Id utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.

author_name
string | null

Nom affiché du créateur, ou null pour une catégorie par défaut.

articles_count
integer

Nombre d'articles publiés de cette catégorie que l'appelant peut voir.

shared_roles
integer[]

Id 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_at
string <date-time> | null
updated_at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 42
slug
string

Slug d'URL, généré à partir du nom.

Exemple: "munkajog"
name
string
Exemple: "Munkajog"
description
string | null

Description en texte brut, ou null.

icon
string | null

Identifiant de l'icône affichée à côté de la catégorie, ou null.

order_column
integer

Position de tri parmi les catégories de même niveau.

Exemple: 0
is_active
boolean
parent_id
integer | null

Id de la catégorie parente, ou null pour une catégorie racine.

author_id
integer

Id utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.

author_name
string | null

Nom affiché du créateur, ou null pour une catégorie par défaut.

articles_count
integer

Nombre d'articles publiés de cette catégorie que l'appelant peut voir.

shared_roles
integer[]

Id 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_at
string <date-time> | null
updated_at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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
}'

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
}

Modifier une catégorie de la base de connaissances

PATCH /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.

Étendue
knowledge:update

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

name
string | nullau moins 1 caractères

Nom 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.

description
string | null

Description en texte brut. null l'efface.

parent_id
integer | null>= 1

Dé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.

icon
string | null

Identifiant d'icône. 100 caractères au maximum pour une NOUVELLE valeur ; "<" et ">" ne peuvent pas être introduits. null l'efface.

is_active
boolean | null

Indicateur d'activité. Omettez-le ou indiquez null pour conserver la valeur actuelle.

order_column
integer | null>= 0

Position de tri parmi les catégories de même niveau. Omettez-la ou indiquez null pour conserver la valeur actuelle.

shared_roles
integer[] | null

Remplace 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.

dataobligatoire
object
Champs de data
id
integer
Exemple: 42
slug
string

Slug d'URL, généré à partir du nom.

Exemple: "munkajog"
name
string
Exemple: "Munkajog"
description
string | null

Description en texte brut, ou null.

icon
string | null

Identifiant de l'icône affichée à côté de la catégorie, ou null.

order_column
integer

Position de tri parmi les catégories de même niveau.

Exemple: 0
is_active
boolean
parent_id
integer | null

Id de la catégorie parente, ou null pour une catégorie racine.

author_id
integer

Id utilisateur du créateur ; 0 pour une catégorie par défaut intégrée, visible par tous.

author_name
string | null

Nom affiché du créateur, ou null pour une catégorie par défaut.

articles_count
integer

Nombre d'articles publiés de cette catégorie que l'appelant peut voir.

shared_roles
integer[]

Id 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_at
string <date-time> | null
updated_at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

E-mails

Lister les e-mails d'un dossier

GET /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.

Étendue
emails:read
Autorisation Flowyer
emails:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

q
stringau maximum 100 caractères

Filtrer par objet, nom ou adresse de l'expéditeur (sans tenir compte des accents ni de la casse). Pas le corps.

Exemple: "invoice"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Identifiant de l'e-mail (à utiliser avec emails.get).

Exemple: 1234
from_name
string | null

Nom 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_address
string | null

Adresse SMTP de la partie externe.

subject
string | null
sent_at
string <date-time> | null

Date 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.

size
integer | null

Taille en octets du fichier .eml/.msg stocké.

extension
string | null

"msg" (complément Outlook) ou "eml" (IMAP / par défaut) ; null sur certaines lignes anciennes.

saved_by_user_id
integer | null

Id utilisateur du membre de l'équipe qui a enregistré l'e-mail dans Flowyer.

saved_by
string | null

Nom affiché de ce membre de l'équipe.

created_at
string <date-time> | null

Date d'enregistrement de l'e-mail dans Flowyer (heure locale du fuseau du cabinet). L'horodatage fiable pour une pagination stable.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un e-mail

GET /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.

Étendue
emails:read
Autorisation Flowyer
emails:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'e-mail.

Exemple: 1234

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 1234
matter
object | null

Le dossier dans lequel l'e-mail est classé, ou null pour un e-mail sans dossier (enregistré hors de tout dossier).

Champs de matter
id
integer
case_number
string
from_name
string | null

Nom affiché de la partie externe (jamais un membre de l'équipe ; le stockage ne comporte pas de colonne de sens).

from_address
string | null

Adresse SMTP de la partie externe.

subject
string | null
body
string | null

Le 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_at
string <date-time> | null

Date 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.

size
integer | null

Taille en octets du fichier .eml/.msg stocké.

extension
string | null

"msg" ou "eml" ; null sur certaines lignes anciennes.

saved_by_user_id
integer | null

Id utilisateur du membre de l'équipe qui a enregistré l'e-mail dans Flowyer.

saved_by
string | null

Nom affiché de ce membre de l'équipe.

created_at
string <date-time> | null

Date d'enregistrement de l'e-mail dans Flowyer (heure locale du fuseau du cabinet).

updated_at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
  }
}

Historique de procédure

Lister l'historique de procédure d'un dossier

GET /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.

Étendue
litigation:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 4521
title
string

Titre de l'entrée. Texte brut.

Exemple: "Első tárgyalás elhalasztva"
description
string | null

Détails de l'entrée en HTML enrichi, nettoyé côté serveur.

location
string | null

Lieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.

event_date
string <date> | null

Jour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.

user_id
integer | null

Auteur (l'utilisateur qui a créé l'entrée).

created_by
string | null

Nom affiché de l'auteur.

last_editor_id
integer | null

Utilisateur ayant modifié l'entrée en dernier.

last_editor
string | null

Nom affiché du dernier rédacteur.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à litigation.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Créer une entrée de l'historique de procédure

POST /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.

Étendue
litigation:create
Autorisation Flowyer
cases:create

Paramètres de chemin

idobligatoire
integer>= 1

Dossier auquel l'entrée appartient (il doit être visible).

Exemple: 1234

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

titleobligatoire
stringau moins 1 caractèresau maximum 2000 caractères

Titre de l'entrée, 2000 caractères au plus. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Első tárgyalás elhalasztva"
description
string | null

Détails de l'entrée. HTML enrichi, nettoyé côté serveur avec le profil de la base de connaissances.

location
string | nullau maximum 255 caractères

Lieu de l'événement (texte brut, 255 caractères au plus) ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Fővárosi Törvényszék, 215. tárgyaló"
event_date
string <date> | null

Jour de l'entrée, YYYY-MM-DD. Par défaut aujourd'hui (fuseau horaire du cabinet).

Exemple: "2026-11-15"
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4521
title
string

Titre de l'entrée. Texte brut.

Exemple: "Első tárgyalás elhalasztva"
description
string | null

Détails de l'entrée en HTML enrichi, nettoyé côté serveur.

location
string | null

Lieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.

event_date
string <date> | null

Jour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.

user_id
integer | null

Auteur (l'utilisateur qui a créé l'entrée).

created_by
string | null

Nom affiché de l'auteur.

last_editor_id
integer | null

Utilisateur ayant modifié l'entrée en dernier.

last_editor
string | null

Nom affiché du dernier rédacteur.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à litigation.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4521
title
string

Titre de l'entrée. Texte brut.

Exemple: "Első tárgyalás elhalasztva"
description
string | null

Détails de l'entrée en HTML enrichi, nettoyé côté serveur.

location
string | null

Lieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.

event_date
string <date> | null

Jour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.

user_id
integer | null

Auteur (l'utilisateur qui a créé l'entrée).

created_by
string | null

Nom affiché de l'auteur.

last_editor_id
integer | null

Utilisateur ayant modifié l'entrée en dernier.

last_editor
string | null

Nom affiché du dernier rédacteur.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à litigation.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier une entrée de l'historique de procédure

PATCH /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.

Étendue
litigation:update
Autorisation Flowyer
cases:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

title
string | nullau moins 1 caractèresau maximum 2000 caractères

Nouveau titre, 2000 caractères au maximum (texte brut ; "<"/">" non autorisés). Omettez-le pour conserver le titre actuel.

Motif: ^[^<>]*$
Exemple: "Ítélethirdetés elhalasztva"
description
string | null

Nouveaux détails (HTML enrichi, nettoyé). Omettez-les pour conserver les détails actuels ; null/vide les efface.

location
string | nullau maximum 255 caractères

Nouveau lieu (texte brut, 255 caractères au maximum ; "<"/">" non autorisés). Omettez-le pour le conserver ; null/vide l'efface.

Motif: ^[^<>]*$
event_date
string <date> | null

Nouveau jour de l'événement, YYYY-MM-DD. Omettez-le pour le conserver ; null l'efface.

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4521
title
string

Titre de l'entrée. Texte brut.

Exemple: "Első tárgyalás elhalasztva"
description
string | null

Détails de l'entrée en HTML enrichi, nettoyé côté serveur.

location
string | null

Lieu de l'événement (texte brut), par exemple une salle d'audience ; peut être null.

event_date
string <date> | null

Jour de l'entrée, YYYY-MM-DD. Flowyer n'enregistre que la date, pas l'heure.

user_id
integer | null

Auteur (l'utilisateur qui a créé l'entrée).

created_by
string | null

Nom affiché de l'auteur.

last_editor_id
integer | null

Utilisateur ayant modifié l'entrée en dernier.

last_editor
string | null

Nom affiché du dernier rédacteur.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à litigation.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Registre du courrier

Lister le registre du courrier

GET /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.

Étendue
mail_register:read
Autorisation Flowyer
mail:read

Paramètres de requête

matter_id
integer>= 1

Uniquement les entrées de ce dossier (il doit être visible pour l'utilisateur).

Exemple: 1234
direction
string

Uniquement les entrées à l'arrivée (reçues) ou au départ (envoyées).

Valeurs autorisées: "incoming" "outgoing"
q
stringau maximum 100 caractères

Recherche en texte libre dans l'objet, l'expéditeur, le destinataire, le réceptionnaire et le numéro de suivi (sans distinction de casse).

Exemple: "Kúria"
date_from
string <date>

Uniquement les entrées dont la date est égale ou postérieure à ce jour (YYYY-MM-DD).

Exemple: "2026-01-01"
date_to
string <date>

Uniquement les entrées dont la date est égale ou antérieure à ce jour (YYYY-MM-DD).

Exemple: "2026-12-31"
updated_since
string <date-time>

Uniquement les entrées modifiées à partir de cet instant (ISO 8601).

Exemple: "2026-10-01T00:00:00+02:00"
include_archived
boolean

Inclure les entrées des dossiers archivés.

Par défaut: false
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Identifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).

Exemple: 4321
matter
object | null

Le dossier sur lequel l'entrée est enregistrée.

Champs de matter
id
integer
case_number
string
direction
string

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
date
string <date> | null

Date postale/d'enregistrement, YYYY-MM-DD (sans heure).

subject
string | null
sender
string | null

Feladó : l'expéditeur (texte libre).

to
string | null

Címzett : le destinataire (texte libre).

recipient
string | null

Pour 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_id
integer | null

Renseigné 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.

electronic
boolean

True lorsque l'élément a été enregistré comme électronique (type_of_mail).

delivery_method_id
integer | null

Identifiant du mode de remise (mail_delivery_methods).

delivery_method
string | null

Libellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.

tracking_no
string | null

Azonosító : numéro de suivi.

folder_path
string | null
recorded_by_user_id
integer | null

Le membre de l'équipe qui a enregistré l'entrée.

recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à mail_register.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une entrée du registre du courrier

GET /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.

Étendue
mail_register:read
Autorisation Flowyer
mail:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant de l'entrée du registre du courrier.

Exemple: 4321

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer

Identifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).

Exemple: 4321
matter
object | null

Le dossier sur lequel l'entrée est enregistrée.

Champs de matter
id
integer
case_number
string
direction
string

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
date
string <date> | null

Date postale/d'enregistrement, YYYY-MM-DD (sans heure).

subject
string | null
sender
string | null

Feladó : l'expéditeur (texte libre).

to
string | null

Címzett : le destinataire (texte libre).

recipient
string | null

Pour 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_id
integer | null

Renseigné 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.

electronic
boolean

True lorsque l'élément a été enregistré comme électronique (type_of_mail).

delivery_method_id
integer | null

Identifiant du mode de remise (mail_delivery_methods).

delivery_method
string | null

Libellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.

tracking_no
string | null

Azonosító : numéro de suivi.

folder_path
string | null
recorded_by_user_id
integer | null

Le membre de l'équipe qui a enregistré l'entrée.

recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à mail_register.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Créer une entrée du registre du courrier

POST /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.

Étendue
mail_register:create
Autorisation Flowyer
mail:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

matter_idobligatoire
integer>= 1

Dossier auquel l'entrée appartient (il doit être visible).

Exemple: 1234
directionobligatoire
string

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
dateobligatoire
string <date>

Date postale/d'enregistrement, YYYY-MM-DD (sans heure).

Exemple: "2026-11-03"
subjectobligatoire
stringau moins 1 caractèresau maximum 1000 caractères

Objet de la correspondance. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Fellebbezés a Kúriához"
sender
string | nullau maximum 1000 caractères

Feladó : l'expéditeur (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
to
string | nullau maximum 1000 caractères

Címzett : le destinataire (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
recipient
string | nullau maximum 1000 caractères

Courrier au départ : le destinataire/réceptionnaire en texte libre. Non autorisé avec recipient_user_id. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
recipient_user_id
integer | null>= 1

Courrier à 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.

electronic
boolean

Indique si l'élément est électronique (type_of_mail) ; indépendant du mode de remise. Valeur par défaut : false.

Par défaut: false
delivery_method_id
integer | null>= 1

Identifiant du mode de remise (mail_delivery_methods) : par exemple 1 Posta, 4 Cégkapu, 7 Perkapu. 422 s'il est inconnu.

tracking_no
string | nullau maximum 255 caractères

Azonosító : numéro de suivi. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
folder_path
string | nullau maximum 1000 caractères
Motif: ^[^<>]*$
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer

Identifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).

Exemple: 4321
matter
object | null

Le dossier sur lequel l'entrée est enregistrée.

Champs de matter
id
integer
case_number
string
direction
string

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
date
string <date> | null

Date postale/d'enregistrement, YYYY-MM-DD (sans heure).

subject
string | null
sender
string | null

Feladó : l'expéditeur (texte libre).

to
string | null

Címzett : le destinataire (texte libre).

recipient
string | null

Pour 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_id
integer | null

Renseigné 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.

electronic
boolean

True lorsque l'élément a été enregistré comme électronique (type_of_mail).

delivery_method_id
integer | null

Identifiant du mode de remise (mail_delivery_methods).

delivery_method
string | null

Libellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.

tracking_no
string | null

Azonosító : numéro de suivi.

folder_path
string | null
recorded_by_user_id
integer | null

Le membre de l'équipe qui a enregistré l'entrée.

recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à mail_register.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer

Identifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).

Exemple: 4321
matter
object | null

Le dossier sur lequel l'entrée est enregistrée.

Champs de matter
id
integer
case_number
string
direction
string

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
date
string <date> | null

Date postale/d'enregistrement, YYYY-MM-DD (sans heure).

subject
string | null
sender
string | null

Feladó : l'expéditeur (texte libre).

to
string | null

Címzett : le destinataire (texte libre).

recipient
string | null

Pour 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_id
integer | null

Renseigné 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.

electronic
boolean

True lorsque l'élément a été enregistré comme électronique (type_of_mail).

delivery_method_id
integer | null

Identifiant du mode de remise (mail_delivery_methods).

delivery_method
string | null

Libellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.

tracking_no
string | null

Azonosító : numéro de suivi.

folder_path
string | null
recorded_by_user_id
integer | null

Le membre de l'équipe qui a enregistré l'entrée.

recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à mail_register.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier une entrée du registre du courrier

PATCH /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.

Étendue
mail_register:update
Autorisation Flowyer
mail:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

direction
string | null

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
date
string <date> | null

Date postale/d'enregistrement, YYYY-MM-DD.

subject
string | nullau moins 1 caractèresau maximum 1000 caractères

Objet. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
sender
string | nullau maximum 1000 caractères

Feladó : l'expéditeur (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
to
string | nullau maximum 1000 caractères

Címzett : le destinataire (texte libre). Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
recipient
string | nullau maximum 1000 caractères

Courrier au départ : le destinataire en texte libre. Non autorisé avec recipient_user_id. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
recipient_user_id
integer | null>= 1

Courrier à 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.

electronic
boolean | null

Indique si l'élément est électronique (type_of_mail).

delivery_method_id
integer | null>= 1

Identifiant du mode de remise (mail_delivery_methods) ; 422 s'il est inconnu.

tracking_no
string | nullau maximum 255 caractères

Azonosító : numéro de suivi. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
folder_path
string | nullau maximum 1000 caractères
Motif: ^[^<>]*$

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer

Identifiant de l'entrée du registre du courrier (à utiliser avec mail_register.get / .update).

Exemple: 4321
matter
object | null

Le dossier sur lequel l'entrée est enregistrée.

Champs de matter
id
integer
case_number
string
direction
string

incoming = reçu, outgoing = envoyé.

Valeurs autorisées: "incoming" "outgoing"
date
string <date> | null

Date postale/d'enregistrement, YYYY-MM-DD (sans heure).

subject
string | null
sender
string | null

Feladó : l'expéditeur (texte libre).

to
string | null

Címzett : le destinataire (texte libre).

recipient
string | null

Pour 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_id
integer | null

Renseigné 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.

electronic
boolean

True lorsque l'élément a été enregistré comme électronique (type_of_mail).

delivery_method_id
integer | null

Identifiant du mode de remise (mail_delivery_methods).

delivery_method
string | null

Libellé localisé du mode de remise (Posta, Cégkapu, Perkapu, ...), ou la valeur de repli électronique/non électronique pour une ligne ancienne.

tracking_no
string | null

Azonosító : numéro de suivi.

folder_path
string | null
recorded_by_user_id
integer | null

Le membre de l'équipe qui a enregistré l'entrée.

recorded_by
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à mail_register.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'entrée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Commentaires

Lister les commentaires d'un dossier

GET /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.

Étendue
comments:read
Autorisation Flowyer
cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier (il doit être visible).

Exemple: 1234

Paramètres de requête

top_level_only
boolean

Uniquement les commentaires de premier niveau (réponses exclues). Valeur par défaut : false.

Par défaut: false
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 9876
matter_id
integer

Le dossier (= case_id) auquel appartient le commentaire.

parent_id
integer | null

Le 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_id
integer | null

Id utilisateur de l'auteur (null pour un import ancien).

author_name
string | null

Nom affiché de l'auteur, ou null.

body
string

Le commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.

created_at
string <date-time> | null

Date de publication du commentaire, ISO 8601 dans le fuseau du cabinet.

updated_at
string <date-time> | null

Jeton 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.

edited
boolean

True lorsque le commentaire a été modifié depuis sa publication.

edited_at
string <date-time> | null

Date 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é.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Publier un commentaire sur un dossier

POST /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.

Étendue
comments:create
Autorisation Flowyer
cases:create

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier (il doit être visible).

Exemple: 1234

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

bodyobligatoire
stringau moins 1 caractères

Le commentaire, en HTML enrichi (tel que produit par TinyMCE). Nettoyé côté serveur par HTMLPurifier avant l'enregistrement. 100000 caractères au plus.

Exemple: "<p>Egyetértek, a határidő tartható.</p>"
parent_id
integer | null>= 1

Ré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_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
matter_id
integer

Le dossier (= case_id) auquel appartient le commentaire.

parent_id
integer | null

Le 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_id
integer | null

Id utilisateur de l'auteur (null pour un import ancien).

author_name
string | null

Nom affiché de l'auteur, ou null.

body
string

Le commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.

created_at
string <date-time> | null

Date de publication du commentaire, ISO 8601 dans le fuseau du cabinet.

updated_at
string <date-time> | null

Jeton 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.

edited
boolean

True lorsque le commentaire a été modifié depuis sa publication.

edited_at
string <date-time> | null

Date 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é.

created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
matter_id
integer

Le dossier (= case_id) auquel appartient le commentaire.

parent_id
integer | null

Le 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_id
integer | null

Id utilisateur de l'auteur (null pour un import ancien).

author_name
string | null

Nom affiché de l'auteur, ou null.

body
string

Le commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.

created_at
string <date-time> | null

Date de publication du commentaire, ISO 8601 dans le fuseau du cabinet.

updated_at
string <date-time> | null

Jeton 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.

edited
boolean

True lorsque le commentaire a été modifié depuis sa publication.

edited_at
string <date-time> | null

Date 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é.

created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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>"
}'

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
}

Modifier son propre commentaire sur un dossier

PATCH /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.

Étendue
comments:update
Autorisation Flowyer
cases:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

bodyobligatoire
stringau moins 1 caractères

Nouveau corps du commentaire, en HTML enrichi (tel que produit par TinyMCE). Nettoyé côté serveur par HTMLPurifier avant stockage. 100000 caractères au maximum.

Exemple: "<p>Pontosítás: a határidő november 15.</p>"

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer
Exemple: 9876
matter_id
integer

Le dossier (= case_id) auquel appartient le commentaire.

parent_id
integer | null

Le 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_id
integer | null

Id utilisateur de l'auteur (null pour un import ancien).

author_name
string | null

Nom affiché de l'auteur, ou null.

body
string

Le commentaire tel que stocké : HTML enrichi, déjà nettoyé par HTMLPurifier pour les commentaires rédigés via cette API.

created_at
string <date-time> | null

Date de publication du commentaire, ISO 8601 dans le fuseau du cabinet.

updated_at
string <date-time> | null

Jeton 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.

edited
boolean

True lorsque le commentaire a été modifié depuis sa publication.

edited_at
string <date-time> | null

Date 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é.

updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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>"
}'

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
}

Audiences

Lister les audiences d'un dossier

GET /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.

Étendue
trials:read
Autorisation Flowyer
trials:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du dossier.

Exemple: 1234

Paramètres de requête

from
string <date>

Uniquement les audiences ayant lieu ce jour ou après (YYYY-MM-DD), dans le fuseau horaire du cabinet.

Exemple: "2026-01-01"
to
string <date>

Uniquement les audiences ayant lieu ce jour ou avant (YYYY-MM-DD), dans le fuseau horaire du cabinet.

Exemple: "2026-12-31"
updated_since
string <date-time>

Uniquement les audiences modifiées à partir de cet instant ISO 8601.

limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 4321
matter
object

Le dossier auquel l'audience appartient.

Champs de matter
id
integer
case_number
string
date
string <date-time> | null

Date 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.

Exemple: "2026-03-02T09:00:00+01:00"
participation
string | null

Indique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.

Valeurs autorisées: "required" "not_required"
court
object | null

La juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.

Champs de court
id
integer
name
string
city
string | null
zip
string | null
address
string | null
source
string

Toujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.

place
string | null

Salle ou lieu de l'audience. Texte brut.

name_of_the_judge
string | null

Nom du juge. Texte brut.

notes
string | null

Notes libres sur l'audience. Texte brut.

responsibles
object[]

Membres de l'équipe présents à l'audience (identifiants issus de colleagues.list).

Champs de responsibles
user_id
integer
name
string | null
recorded_by
object | null

Le membre de l'équipe qui a enregistré l'audience.

Champs de recorded_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à trials.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une audience

GET /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.

Étendue
trials:read
Autorisation Flowyer
trials:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant de l'audience.

Exemple: 4321

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
matter
object

Le dossier auquel l'audience appartient.

Champs de matter
id
integer
case_number
string
date
string <date-time> | null

Date 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.

Exemple: "2026-03-02T09:00:00+01:00"
participation
string | null

Indique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.

Valeurs autorisées: "required" "not_required"
court
object | null

La juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.

Champs de court
id
integer
name
string
city
string | null
zip
string | null
address
string | null
source
string

Toujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.

place
string | null

Salle ou lieu de l'audience. Texte brut.

name_of_the_judge
string | null

Nom du juge. Texte brut.

notes
string | null

Notes libres sur l'audience. Texte brut.

responsibles
object[]

Membres de l'équipe présents à l'audience (identifiants issus de colleagues.list).

Champs de responsibles
user_id
integer
name
string | null
recorded_by
object | null

Le membre de l'équipe qui a enregistré l'audience.

Champs de recorded_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à trials.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Créer une audience

POST /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.

Étendue
trials:create
Autorisation Flowyer
trials:create

Paramètres de chemin

idobligatoire
integer>= 1

Dossier auquel l'audience appartient (il doit être visible et non archivé).

Exemple: 1234

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

dateobligatoire
string <date-time>

Date 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.

Exemple: "2026-03-02T09:00:00+01:00"
court_id
integer | null>= 1

Juridiction de l'audience : un identifiant issu de courts.list (le registre partagé des juridictions). Omettez-le lorsque la juridiction n'est pas connue.

Exemple: 42
participation
string | null

Indique si la présence d'un membre de l'équipe est requise. Omettez-le pour ne pas le renseigner.

Valeurs autorisées: "required" "not_required"
place
string | nullau maximum 1000 caractères

Salle ou lieu de l'audience. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "II. emelet 205."
name_of_the_judge
string | nullau maximum 255 caractères

Nom du juge. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
notes
string | nullau maximum 10000 caractères

Notes libres sur l'audience. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
responsible_user_ids
integer[] | null

Identifiants d'utilisateur (issus de colleagues.list) des membres de l'équipe présents à l'audience.

idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
matter
object

Le dossier auquel l'audience appartient.

Champs de matter
id
integer
case_number
string
date
string <date-time> | null

Date 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.

Exemple: "2026-03-02T09:00:00+01:00"
participation
string | null

Indique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.

Valeurs autorisées: "required" "not_required"
court
object | null

La juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.

Champs de court
id
integer
name
string
city
string | null
zip
string | null
address
string | null
source
string

Toujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.

place
string | null

Salle ou lieu de l'audience. Texte brut.

name_of_the_judge
string | null

Nom du juge. Texte brut.

notes
string | null

Notes libres sur l'audience. Texte brut.

responsibles
object[]

Membres de l'équipe présents à l'audience (identifiants issus de colleagues.list).

Champs de responsibles
user_id
integer
name
string | null
recorded_by
object | null

Le membre de l'équipe qui a enregistré l'audience.

Champs de recorded_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à trials.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
matter
object

Le dossier auquel l'audience appartient.

Champs de matter
id
integer
case_number
string
date
string <date-time> | null

Date 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.

Exemple: "2026-03-02T09:00:00+01:00"
participation
string | null

Indique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.

Valeurs autorisées: "required" "not_required"
court
object | null

La juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.

Champs de court
id
integer
name
string
city
string | null
zip
string | null
address
string | null
source
string

Toujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.

place
string | null

Salle ou lieu de l'audience. Texte brut.

name_of_the_judge
string | null

Nom du juge. Texte brut.

notes
string | null

Notes libres sur l'audience. Texte brut.

responsibles
object[]

Membres de l'équipe présents à l'audience (identifiants issus de colleagues.list).

Champs de responsibles
user_id
integer
name
string | null
recorded_by
object | null

Le membre de l'équipe qui a enregistré l'audience.

Champs de recorded_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à trials.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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."
}'

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
}

Modifier une audience

PATCH /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.

Étendue
trials:update
Autorisation Flowyer
trials:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

date
string <date-time>

Nouvelle 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.

Exemple: "2026-03-02T09:00:00+01:00"
court_id
integer | null>= 1

Nouvel identifiant de juridiction issu de courts.list ; null pour retirer la juridiction.

participation
string | null

Indique si la présence d'un membre de l'équipe est requise ; null pour l'effacer.

Valeurs autorisées: "required" "not_required"
place
string | nullau maximum 1000 caractères

Salle ou lieu. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.

Motif: ^[^<>]*$
name_of_the_judge
string | nullau maximum 255 caractères

Nom du juge. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.

Motif: ^[^<>]*$
notes
string | nullau maximum 10000 caractères

Notes libres. Texte brut ; "<" et ">" ne sont pas autorisés. "" les efface.

Motif: ^[^<>]*$
responsible_user_ids
integer[] | null

Ensemble 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.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
matter
object

Le dossier auquel l'audience appartient.

Champs de matter
id
integer
case_number
string
date
string <date-time> | null

Date 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.

Exemple: "2026-03-02T09:00:00+01:00"
participation
string | null

Indique si la présence d'un membre de l'équipe est requise : "required", "not_required", ou null si non renseigné.

Valeurs autorisées: "required" "not_required"
court
object | null

La juridiction de l'audience, résolue à partir du registre partagé des juridictions ; null si aucune juridiction n'est renseignée.

Champs de court
id
integer
name
string
city
string | null
zip
string | null
address
string | null
source
string

Toujours "registry" : la juridiction est une référence au registre partagé des juridictions (courts.list), et non du texte libre.

place
string | null

Salle ou lieu de l'audience. Texte brut.

name_of_the_judge
string | null

Nom du juge. Texte brut.

notes
string | null

Notes libres sur l'audience. Texte brut.

responsibles
object[]

Membres de l'équipe présents à l'audience (identifiants issus de colleagues.list).

Champs de responsibles
user_id
integer
name
string | null
recorded_by
object | null

Le membre de l'équipe qui a enregistré l'audience.

Champs de recorded_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à trials.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Juridictions

Lister les juridictions

GET /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.

Étendue
courts:read

Paramètres de requête

q
stringau maximum 255 caractères

Nom de la juridiction à rechercher, tel qu'entendu ou dicté, dans n'importe quel ordre des mots. Omettez-le pour lister toutes les juridictions.

Exemple: "Fővárosi Törvényszék"
limit
integer>= 1<= 500

Nombre maximal de juridictions à renvoyer (par défaut 200).

Par défaut: 200

Réponses

200

OK.

dataobligatoire
object
Champs de data
status
string | null

Uniquement 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.

Valeurs autorisées: "exact" "similar" "none"
courts
object[]

Juridictions, meilleure correspondance en premier avec q, sinon par nom.

Champs de courts
id
integer

Id de la juridiction : transmettez-le comme court_id à trials.create / trials.update.

name
string

Nom de la juridiction tel qu'affiché dans Flowyer.

city
string | null
zip
string | null
address
string | null
total
integer

Nombre de juridictions correspondantes (toutes les juridictions sans q) avant que la liste ne soit tronquée à limit.

truncated
boolean

True 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

Exemples de réponses

{
  "data": {
    "status": "exact",
    "courts": [
      {
        "id": 1234,
        "name": "string",
        "city": "string",
        "zip": "string",
        "address": "string"
      }
    ],
    "total": 1,
    "truncated": true
  }
}

RH

Lister les absences de l'équipe

GET /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.

Étendue
hr:read
Autorisation Flowyer
hr-admin:read

Paramètres de requête

user_id
integer>= 1

Uniquement 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.

Exemple: 1234
on_date
string <date>

Qui 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_from
string <date>

Uniquement 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_to
string <date>

Uniquement les absences commençant à cette date ou avant (start_date <= date_to). Omettez-le pour un futur sans limite.

timeframe
string

Contrainte 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.

Valeurs autorisées: "current" "upcoming" "all"
Par défaut: "all"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Id de la demande d'absence (simple référence ; non sensible).

user_id
integer

Le membre de l'équipe absent (id utilisateur central).

user
string | null

Nom affiché du membre de l'équipe.

start_date
string <date>

Premier jour d'absence (YYYY-MM-DD).

end_date
string <date>

Dernier jour d'absence, inclus (YYYY-MM-DD).

days_count
number | null

Jours ouvrés d'absence. Ne révèle pas le type.

category
string

Type 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é.

Valeurs autorisées: "leave" "unpaid"
status
string

Toujours "approved" : seules les absences approuvées sont renvoyées ; pending, rejected et cancelled n'apparaissent jamais.

Valeurs autorisées: "approved"
substitute_user_id
integer | null

Membre de l'équipe remplaçant pendant cette absence (id utilisateur central), ou null.

substitute_user
string | null

Nom affiché du remplaçant, ou null.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Agenda

Lister les événements de l'agenda

GET /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.

Étendue
calendar:read
Autorisation Flowyer
calendar-office:read

Paramètres de requête

fromobligatoire
string <date-time>

Dé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.

Exemple: "2026-03-01T00:00:00+01:00"
toobligatoire
string <date-time>

Fin de la plage (incluse), ISO 8601. Doit être égale ou postérieure à from (sinon 422) et au plus 366 jours après.

Exemple: "2026-03-31T23:59:59+01:00"
calendar_ids
integer[]

Restreint à 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_recurring
boolean

Inclut 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.

Par défaut: true
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 5501
calendar
object

L'agenda auquel appartient l'événement.

Champs de calendar
id
integer | null

Id de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).

name
string | null
type
string

"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é.

Valeurs autorisées: "office" "personal"
owner
object | null

Propriétaire d'un agenda personnel ; null pour l'agenda du cabinet.

Champs de owner
user_id
integer
name
string | null
title
string | null

Titre de l'événement. Texte brut.

description
string | null

Description de l'événement. Texte brut.

location
string | null

Lieu. Texte brut.

participants
string | null

Participants, texte libre. Texte brut.

start
string | null

É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é).

Exemple: "2026-03-02T09:00:00+01:00"
end
string | null

Mê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_day
boolean

True 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).

color
string | null

Couleur d'affichage, par exemple "#2c7be5".

is_recurring
boolean

True 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.

recurrence
object | null

La 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
freq
string | null

daily | weekly | monthly | yearly.

interval
integer | null
byweekday
string | null

Codes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").

until
string | null
count
integer | null
created_by
object | null

Le membre de l'équipe qui a créé l'événement.

Champs de created_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à calendar.events.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un événement d'agenda

GET /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.

Étendue
calendar:read
Autorisation Flowyer
calendar-office:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'événement.

Exemple: 5501

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 5501
calendar
object

L'agenda auquel appartient l'événement.

Champs de calendar
id
integer | null

Id de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).

name
string | null
type
string

"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é.

Valeurs autorisées: "office" "personal"
owner
object | null

Propriétaire d'un agenda personnel ; null pour l'agenda du cabinet.

Champs de owner
user_id
integer
name
string | null
title
string | null

Titre de l'événement. Texte brut.

description
string | null

Description de l'événement. Texte brut.

location
string | null

Lieu. Texte brut.

participants
string | null

Participants, texte libre. Texte brut.

start
string | null

É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é).

Exemple: "2026-03-02T09:00:00+01:00"
end
string | null

Mê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_day
boolean

True 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).

color
string | null

Couleur d'affichage, par exemple "#2c7be5".

is_recurring
boolean

True 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.

recurrence
object | null

La 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
freq
string | null

daily | weekly | monthly | yearly.

interval
integer | null
byweekday
string | null

Codes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").

until
string | null
count
integer | null
created_by
object | null

Le membre de l'équipe qui a créé l'événement.

Champs de created_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à calendar.events.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Créer un événement d'agenda

POST /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.

Étendue
calendar:create
Autorisation Flowyer
calendar-office:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

titleobligatoire
stringau moins 1 caractèresau maximum 255 caractères

Titre de l'événement. Texte brut ; "<" et ">" ne sont pas autorisés (il est repris sans échappement dans la notification de rappel).

Motif: ^[^<>]*$
Exemple: "Ügyfél egyeztetés"
startobligatoire
string

Journé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.

Exemple: "2026-03-02T09:00:00+01:00"
end
string | null

Mê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_day
boolean

Indique si l'événement dure toute la journée. Par défaut false (horaire).

Par défaut: false
calendar_id
integer | null>= 1

L'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.

location
string | nullau maximum 1000 caractères

Lieu. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
description
string | nullau maximum 10000 caractères

Description, texte brut (pas de HTML) ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
participants
string | nullau maximum 1000 caractères

Participants, texte libre. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
color
string | nullau maximum 32 caractères

Couleur d'affichage, par exemple "#2c7be5".

Motif: ^#?[A-Za-z0-9_-]{1,31}$
idempotency_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 5501
calendar
object

L'agenda auquel appartient l'événement.

Champs de calendar
id
integer | null

Id de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).

name
string | null
type
string

"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é.

Valeurs autorisées: "office" "personal"
owner
object | null

Propriétaire d'un agenda personnel ; null pour l'agenda du cabinet.

Champs de owner
user_id
integer
name
string | null
title
string | null

Titre de l'événement. Texte brut.

description
string | null

Description de l'événement. Texte brut.

location
string | null

Lieu. Texte brut.

participants
string | null

Participants, texte libre. Texte brut.

start
string | null

É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é).

Exemple: "2026-03-02T09:00:00+01:00"
end
string | null

Mê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_day
boolean

True 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).

color
string | null

Couleur d'affichage, par exemple "#2c7be5".

is_recurring
boolean

True 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.

recurrence
object | null

La 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
freq
string | null

daily | weekly | monthly | yearly.

interval
integer | null
byweekday
string | null

Codes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").

until
string | null
count
integer | null
created_by
object | null

Le membre de l'équipe qui a créé l'événement.

Champs de created_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à calendar.events.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 5501
calendar
object

L'agenda auquel appartient l'événement.

Champs de calendar
id
integer | null

Id de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).

name
string | null
type
string

"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é.

Valeurs autorisées: "office" "personal"
owner
object | null

Propriétaire d'un agenda personnel ; null pour l'agenda du cabinet.

Champs de owner
user_id
integer
name
string | null
title
string | null

Titre de l'événement. Texte brut.

description
string | null

Description de l'événement. Texte brut.

location
string | null

Lieu. Texte brut.

participants
string | null

Participants, texte libre. Texte brut.

start
string | null

É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é).

Exemple: "2026-03-02T09:00:00+01:00"
end
string | null

Mê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_day
boolean

True 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).

color
string | null

Couleur d'affichage, par exemple "#2c7be5".

is_recurring
boolean

True 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.

recurrence
object | null

La 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
freq
string | null

daily | weekly | monthly | yearly.

interval
integer | null
byweekday
string | null

Codes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").

until
string | null
count
integer | null
created_by
object | null

Le membre de l'équipe qui a créé l'événement.

Champs de created_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à calendar.events.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier un événement d'agenda

PATCH /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.

Étendue
calendar:update
Autorisation Flowyer
calendar-office:modify

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

title
stringau moins 1 caractèresau maximum 255 caractères

Nouveau titre. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
start
string

Nouveau 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.

end
string | null

Nouvelle 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_day
boolean

S'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.

location
string | nullau maximum 1000 caractères

Lieu. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.

Motif: ^[^<>]*$
description
string | nullau maximum 10000 caractères

Description, texte brut (pas de HTML) ; "<" et ">" ne sont pas autorisés. "" l'efface.

Motif: ^[^<>]*$
participants
string | nullau maximum 1000 caractères

Participants, texte libre. Texte brut ; "<" et ">" ne sont pas autorisés. "" l'efface.

Motif: ^[^<>]*$
color
string | nullau maximum 32 caractères

Couleur d'affichage, par exemple "#2c7be5". "" l'efface.

Motif: ^#?[A-Za-z0-9_-]{1,31}$

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer
Exemple: 5501
calendar
object

L'agenda auquel appartient l'événement.

Champs de calendar
id
integer | null

Id de l'agenda conteneur, ou null pour l'agenda partagé implicite du cabinet (un ancien événement sans conteneur).

name
string | null
type
string

"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é.

Valeurs autorisées: "office" "personal"
owner
object | null

Propriétaire d'un agenda personnel ; null pour l'agenda du cabinet.

Champs de owner
user_id
integer
name
string | null
title
string | null

Titre de l'événement. Texte brut.

description
string | null

Description de l'événement. Texte brut.

location
string | null

Lieu. Texte brut.

participants
string | null

Participants, texte libre. Texte brut.

start
string | null

É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é).

Exemple: "2026-03-02T09:00:00+01:00"
end
string | null

Mê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_day
boolean

True 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).

color
string | null

Couleur d'affichage, par exemple "#2c7be5".

is_recurring
boolean

True 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.

recurrence
object | null

La 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
freq
string | null

daily | weekly | monthly | yearly.

interval
integer | null
byweekday
string | null

Codes de jours de la semaine séparés par des virgules (par exemple "MO,WE,FR").

until
string | null
count
integer | null
created_by
object | null

Le membre de l'équipe qui a créé l'événement.

Champs de created_by
user_id
integer
name
string | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à calendar.events.update comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé l'enregistrement via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Prise de rendez-vous

Lister les réservations

GET /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.

Étendue
bookings:read

Paramètres de requête

from
string <date>

Uniquement les réservations à partir de ce jour inclus (YYYY-MM-DD), comparé littéralement à la date dans le fuseau de réservation.

Exemple: "2026-01-01"
to
string <date>

Uniquement les réservations jusqu'à ce jour inclus (YYYY-MM-DD).

Exemple: "2026-12-31"
user_id
integer>= 1

Filtrer sur un seul avocat (user_id issu de colleagues.list). Omettez-le pour tous les avocats du cabinet.

status
string

Filtrer par statut.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
updated_since
string <date-time>

Uniquement 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).

limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir une réservation

GET /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.

Étendue
bookings:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de la réservation.

Exemple: 4321

Réponses

200

OK.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Créer une réservation

POST /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.

Étendue
bookings:create

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

user_idobligatoire
integer>= 1

Avocat avec qui le rendez-vous a lieu (user_id issu de colleagues.list ; doit être un membre actif de l'équipe du cabinet).

Exemple: 42
dateobligatoire
string <date>

Jour du rendez-vous (YYYY-MM-DD) dans le fuseau horaire de réservation.

Exemple: "2026-03-02"
timeobligatoire
string

Heure 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.

Motif: ^([01]\d|2[0-3]):[0-5]\d$
Exemple: "09:00"
client_nameobligatoire
stringau maximum 255 caractères

Nom du client. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
Exemple: "Kovács Anna"
client_emailobligatoire
stringau maximum 255 caractères

E-mail du client : destinataire de la confirmation.

Exemple: "anna@example.com"
client_phone
string | nullau maximum 50 caractères

Téléphone du client. Texte brut.

Motif: ^[^<>]*$
client_description
string | nullau maximum 2000 caractères

Objet / notes du client. Texte brut.

Motif: ^[^<>]*$
location_preference
string

Consultation au cabinet ou en ligne. Par défaut "office".

Valeurs autorisées: "office" "online"
Par défaut: "office"
meeting_link
string | nullau maximum 500 caractères

URL de la réunion en ligne (http/https), pour une consultation en ligne.

gdpr_consent
boolean

Enregistre 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).

Par défaut: true
auto_confirm
boolean

Si 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.

Par défaut: false
confirm_token
string

Two-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_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Modifier une réservation

PATCH /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.

Étendue
bookings:update

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

date
string <date>

Nouveau jour (YYYY-MM-DD) dans le fuseau horaire de réservation. Envoyez date ET time ensemble pour reprogrammer.

Exemple: "2026-03-05"
time
string

Nouvelle 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.

Motif: ^([01]\d|2[0-3]):[0-5]\d$
Exemple: "11:00"
client_phone
string | nullau maximum 50 caractères

Téléphone du client. Texte brut. "" l'efface.

Motif: ^[^<>]*$
client_description
string | nullau maximum 2000 caractères

Objet / notes. Texte brut. "" l'efface.

Motif: ^[^<>]*$
meeting_link
string | nullau maximum 500 caractères

URL de la réunion en ligne (http/https). "" l'efface.

location_preference
string

Consultation au cabinet ou en ligne.

Valeurs autorisées: "office" "online"

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Confirmer une réservation

POST /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.

Étendue
bookings:send

Paramètres de chemin

idobligatoire
integer>= 1

Id de la réservation.

Exemple: 4321

Corps de la requête application/json

expected_updated_at
string <date-time> | null

Jeton 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_link
string | nullau maximum 500 caractères

URL de la réunion en ligne (http/https) à définir sur la réservation avant l'envoi de l'e-mail de confirmation.

confirm_token
string

Two-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.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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"
    }
  }
}

Annuler une réservation

POST /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.

Étendue
bookings:send

Paramètres de chemin

idobligatoire
integer>= 1

Id de la réservation.

Exemple: 4321

Corps de la requête application/json

expected_updated_at
string <date-time> | null

Jeton de verrouillage optimiste facultatif : l'updated_at de votre dernière lecture. Si la réservation a changé depuis, l'API répond 409.

reason
string | nullau maximum 255 caractères

Motif enregistré dans cancel_reason et affiché dans l'e-mail d'annulation. Texte brut ; "<" et ">" ne sont pas autorisés.

Motif: ^[^<>]*$
confirm_token
string

Two-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.

dataobligatoire
object
Champs de data
id
integer
Exemple: 4321
booking_number
string

Numéro de réservation lisible, par exemple "#B-0001".

status
string

pending = en attente de confirmation par l'avocat ; confirmed = approuvée ; cancelled/completed ; awaiting_payment/expired relèvent du parcours de paiement avant confirmation.

Valeurs autorisées: "pending" "confirmed" "cancelled" "completed" "awaiting_payment" "expired"
source
string

Origine de la réservation. Une réservation créée par l'API vaut "manual".

Valeurs autorisées: "flowyer" "website" "embed_widget" "manual"
lawyer
object | null

L'avocat (user_id issu de colleagues.list) avec qui le rendez-vous a lieu.

Champs de lawyer
user_id
integer
name
string | null
date
string <date> | null

Date calendaire dans le fuseau horaire de réservation (YYYY-MM-DD), stockée telle quelle.

start_time
string | null

Heure de début HH:MM dans le fuseau horaire de réservation.

end_time
string | null

Heure de fin HH:MM dans le fuseau horaire de réservation.

start
string <date-time> | null

Instant ISO 8601 non ambigu du début, composé avec le fuseau horaire de réservation. Utilisez-le pour comparer des instants entre fuseaux.

end
string <date-time> | null

Instant ISO 8601 non ambigu de la fin.

timezone
string

Le fuseau horaire de réservation (booking_settings.timezone), par exemple "Europe/Budapest". Il régit date, start_time et end_time.

location_preference
string

Indique si la consultation a lieu au cabinet ou en ligne.

Valeurs autorisées: "office" "online"
meeting_link
string | null

URL de la réunion en ligne, si elle est définie.

client
object

Le 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
name
string | null
email
string | null
phone
string | null
description
string | null
gdpr_consent
boolean

Indique si le consentement du client au traitement de ses données est enregistré.

gdpr_consent_at
string <date-time> | null

Date d'enregistrement du consentement.

cancel_reason
string | null

Motif enregistré lors de l'annulation.

payment
object

É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
string
Valeurs autorisées: "none" "awaiting" "partial" "paid" "refunded"
method
string | null
Valeurs autorisées: "card" "transfer"
amount
number | null
currency
string | null
invoice_number
string | null
confirmed_at
string <date-time> | null
cancelled_at
string <date-time> | null
created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à bookings.update / bookings.confirm / bookings.cancel comme expected_updated_at.

created_via_api
object | null

Présent lorsqu'un agent externe a créé la réservation via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
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é.

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).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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"
    }
  }
}

Tickets

Lister les tickets

GET /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.

Étendue
tickets:read
Autorisation Flowyer
ticketing:read

Paramètres de requête

status
string

open_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.

Valeurs autorisées: "new" "open" "pending" "closed" "open_states" "all"
Par défaut: "open_states"
mailbox_id
integer>= 1

Uniquement 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).

Exemple: 7
assigned_to_user_id
integer>= 0

Uniquement 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_email
stringau maximum 255 caractères

Uniquement les tickets dont l'e-mail du demandeur externe correspond exactement (sans distinction de casse).

Exemple: "ugyfel@example.com"
q
stringau maximum 100 caractères

Recherche en texte libre sur l'objet, le nom/l'e-mail du demandeur et le numéro de ticket (sans distinction de casse).

Exemple: "számla"
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Identifiant du ticket (à utiliser avec tickets.get / tickets.update).

Exemple: 4321
ticket_number
string | null

Numéro de ticket lisible, par exemple FLW-000123.

subject
string | null
status
string
Valeurs autorisées: "new" "open" "pending" "closed"
priority
string
Valeurs autorisées: "low" "normal" "high"
mailbox
object | null

La boîte mail par laquelle le ticket est arrivé (registre central).

Champs de mailbox
id
integer
email
string | null
display_name
string | null
requester
object

La personne externe qui a écrit.

Champs de requester
email
string | null
name
string | null
assigned_to
object | null

Le membre de l'équipe auquel le ticket est attribué, ou null s'il n'est pas attribué.

Champs de assigned_to
user_id
integer
name
string | null
matter
object | null

Le dossier lié au ticket, ou null.

Champs de matter
id
integer
case_number
string
client
object | null

Le client lié au ticket, ou null.

Champs de client
id
integer
name
string
last_message_at
string <date-time> | null

Heure de la dernière activité du fil ; la liste est triée selon cette valeur, de la plus récente à la plus ancienne.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à tickets.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsque le ticket a été créé via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Obtenir un ticket

GET /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).

Étendue
tickets:read
Autorisation Flowyer
ticketing:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du ticket.

Exemple: 4321

Paramètres de requête

messages_limit
integer | null>= 1<= 500

Renvoyer 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.

dataobligatoire
object
Champs de data
id
integer

Identifiant du ticket (à utiliser avec tickets.get / tickets.update).

Exemple: 4321
ticket_number
string | null

Numéro de ticket lisible, par exemple FLW-000123.

subject
string | null
status
string
Valeurs autorisées: "new" "open" "pending" "closed"
priority
string
Valeurs autorisées: "low" "normal" "high"
mailbox
object | null

La boîte mail par laquelle le ticket est arrivé (registre central).

Champs de mailbox
id
integer
email
string | null
display_name
string | null
requester
object

La personne externe qui a écrit.

Champs de requester
email
string | null
name
string | null
assigned_to
object | null

Le membre de l'équipe auquel le ticket est attribué, ou null s'il n'est pas attribué.

Champs de assigned_to
user_id
integer
name
string | null
matter
object | null

Le dossier lié au ticket, ou null.

Champs de matter
id
integer
case_number
string
client
object | null

Le client lié au ticket, ou null.

Champs de client
id
integer
name
string
last_message_at
string <date-time> | null

Heure de la dernière activité du fil ; la liste est triée selon cette valeur, de la plus récente à la plus ancienne.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à tickets.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsque le ticket a été créé via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
messages
object[]

Le fil de messages, des plus anciens aux plus récents.

Champs de messages
id
integer
direction
string

in = du demandeur, out = réponse/accusé de réception automatique envoyé depuis la boîte mail, note = interne.

Valeurs autorisées: "in" "out" "note"
from
object
Champs de from
email
string | null
name
string | null
to
object[]
Champs de to
email
string
name
string | null
cc
object[]
Champs de cc
email
string
name
string | null
sent_status
string | null

État de remise d'un message sortant ; null pour in/note.

Valeurs autorisées: "pending" "sent" "failed" "scheduled"
body_text
string | null

Corps 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_attachments
boolean
author
object | null

Le membre de l'équipe qui a rédigé un message out/note ; null pour un message entrant.

Champs de author
user_id
integer
name
string | null
created_at
string <date-time> | null
linked_matter
object | null

Le dossier lié au ticket (identique à matter).

Champs de linked_matter
id
integer
case_number
string
linked_client
object | null

Le client lié au ticket (identique à client).

Champs de linked_client
id
integer
name
string
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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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"
    }
  }
}

Répondre à un ticket

POST /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.

Étendue
tickets:reply
Autorisation Flowyer
ticketing:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du ticket (il doit être visible via l'ACL de la boîte mail).

Exemple: 4321

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

body_htmlobligatoire
stringau moins 1 caractères

La 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.

Exemple: "<p>Köszönjük megkeresését, csatoltan küldjük a választ.</p>"
cc
string[]au maximum 10 éléments

Destinataires Cc supplémentaires (10 au plus). Le demandeur et la boîte mail sont exclus automatiquement ; une adresse invalide renvoie 422.

status
string

Statut 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.

Valeurs autorisées: "new" "open" "pending" "closed"
Par défaut: "pending"
append_signature
boolean

Ajouter la signature de ticket enregistrée de l'utilisateur de la clé UNIQUEMENT à l'e-mail SORTANT (jamais enregistrée dans le fil).

Par défaut: false
confirm_token
string

Two-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_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
ticket_id
integer
Exemple: 4321
message_id
integer

Identifiant de la ligne ticket_messages sortante créée.

Exemple: 98765
direction
string

Toujours "out".

sent_status
string | null

"pending" au moment de la création ; l'envoi asynchrone le fait ensuite passer à sent/failed.

Valeurs autorisées: "pending" "sent" "failed" "scheduled"
status
string

Le statut du ticket après la réponse.

Valeurs autorisées: "new" "open" "pending" "closed"
created_at
string <date-time> | null
created_via_api
object | null

Présent lorsque la réponse a été créée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
ticket_id
integer
Exemple: 4321
message_id
integer

Identifiant de la ligne ticket_messages sortante créée.

Exemple: 98765
direction
string

Toujours "out".

sent_status
string | null

"pending" au moment de la création ; l'envoi asynchrone le fait ensuite passer à sent/failed.

Valeurs autorisées: "pending" "sent" "failed" "scheduled"
status
string

Le statut du ticket après la réponse.

Valeurs autorisées: "new" "open" "pending" "closed"
created_at
string <date-time> | null
created_via_api
object | null

Présent lorsque la réponse a été créée via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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>"
}'

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
}

Modifier le statut d'un ticket

PATCH /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.

Étendue
tickets:update
Autorisation Flowyer
ticketing:read

Paramètres de chemin

idobligatoire
integer>= 1

Id de l'enregistrement à modifier.

Corps de la requête application/json

expected_updated_at
string <date-time> | null

La 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.

statusobligatoire
string

Le nouveau statut. "closed" renseigne closed_at ; tout autre statut l'efface.

Valeurs autorisées: "new" "open" "pending" "closed"
Exemple: "open"

Réponses

200

Mis à jour.

dataobligatoire
object
Champs de data
id
integer

Identifiant du ticket (à utiliser avec tickets.get / tickets.update).

Exemple: 4321
ticket_number
string | null

Numéro de ticket lisible, par exemple FLW-000123.

subject
string | null
status
string
Valeurs autorisées: "new" "open" "pending" "closed"
priority
string
Valeurs autorisées: "low" "normal" "high"
mailbox
object | null

La boîte mail par laquelle le ticket est arrivé (registre central).

Champs de mailbox
id
integer
email
string | null
display_name
string | null
requester
object

La personne externe qui a écrit.

Champs de requester
email
string | null
name
string | null
assigned_to
object | null

Le membre de l'équipe auquel le ticket est attribué, ou null s'il n'est pas attribué.

Champs de assigned_to
user_id
integer
name
string | null
matter
object | null

Le dossier lié au ticket, ou null.

Champs de matter
id
integer
case_number
string
client
object | null

Le client lié au ticket, ou null.

Champs de client
id
integer
name
string
last_message_at
string <date-time> | null

Heure de la dernière activité du fil ; la liste est triée selon cette valeur, de la plus récente à la plus ancienne.

created_at
string <date-time> | null
updated_at
string <date-time> | null

Transmettez cette valeur à tickets.update en tant que expected_updated_at.

created_via_api
object | null

Présent lorsque le ticket a été créé via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
updated
boolean
Valeur: true
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é.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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"
}'

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
}

Portail client

Lister les portails clients

GET /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.

Étendue
portal:read
Autorisation Flowyer
client-portal:read, cases:read

Paramètres de requête

matter_id
integer>= 1

Uniquement le portail de ce dossier (404 matter_not_visible lorsque le dossier n'est pas visible). Un dossier a au plus un portail.

Exemple: 1234
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

Identifiant du portail (fil) - la référence pour portal.messages.list et portal.reply.

Exemple: 57
matter
object

Le dossier auquel le portail appartient.

Champs de matter
id
integer
case_number
string
client_participants
object[]

Les participants externes côté client avec lesquels le cabinet échange.

Champs de client_participants
name
string | null
kind
string

client = un mandant, contact = un contact du client, email = un ancien accès par e-mail uniquement.

Valeurs autorisées: "client" "contact" "email"
participant_count
integer

Nombre de participants actifs (équipe et client).

message_count
integer

Nombre de messages non supprimés dans le fil.

last_message_at
string <date-time> | null

Heure de publication du message non supprimé le plus récent, ISO 8601 dans le fuseau du cabinet ; null pour un fil vide.

unread_for_me
integer | null

Messages non lus pour la ligne de participant propre à l'utilisateur agissant ; null lorsque l'utilisateur agissant n'est pas participant de ce portail.

created_at
string <date-time> | null
paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Lister les messages du portail

GET /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.

Étendue
portal:read
Autorisation Flowyer
client-portal:read, cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du portail (il doit être accessible).

Exemple: 57

Paramètres de requête

include_deleted
boolean

Inclure les messages supprimés (leur corps est vidé). Valeur par défaut : false.

Par défaut: false
limit
integer>= 1<= 100

Taille de page, de 1 à 100. Par défaut : 25.

Par défaut: 25
Exemple: 25
offset
integer>= 0

Nombre d'enregistrements à ignorer. Utilisez offset + limit de la page précédente pour obtenir la suivante ; pagination.total indique le nombre total.

Par défaut: 0
Exemple: 0

Réponses

200

OK.

dataobligatoire
object[]
Champs de data
id
integer

portal_messages.id.

Exemple: 8012
author
object

Auteur du message.

Champs de author
participant_id
integer | null
name
string | null
kind
string

staff = un membre de l'équipe du cabinet, client = le client externe.

Valeurs autorisées: "staff" "client"
direction
string

from_firm = un auteur membre de l'équipe, from_client = le client externe.

Valeurs autorisées: "from_firm" "from_client"
body
string

Le message en texte brut (<br> converti en sauts de ligne). Chaîne vide pour un message supprimé.

attachment
object | null

Mé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_id
integer
file_name
string
is_deleted
boolean
deleted_at
string <date-time> | null
created_at
string <date-time> | null

Heure de publication du message, ISO 8601 dans le fuseau du cabinet.

paginationobligatoire
object
Champs de pagination
limitobligatoire
integer
offsetobligatoire
integer
totalobligatoire
integer

Nombre 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é.

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.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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_...'

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
  }
}

Répondre dans le portail client

POST /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.

Étendue
portal:reply
Autorisation Flowyer
client-portal:read, cases:read

Paramètres de chemin

idobligatoire
integer>= 1

Identifiant du portail dans lequel répondre (il doit être accessible).

Exemple: 57

Paramètres d'en-tête

Idempotency-Key
stringau maximum 128 caractères

Recommandé 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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$

Corps de la requête application/json

bodyobligatoire
stringau moins 1 caractèresau maximum 20000 caractères

La réponse, en texte brut. Les chevrons sont acceptés et échappés à l'enregistrement. 20000 caractères au plus.

Exemple: "Tisztelt Ügyfelünk! A beadványt ma benyújtottuk."
confirm_token
string

Two-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_key
stringau maximum 128 caractères

Mê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.

Motif: ^[A-Za-z0-9_\-:.]{1,128}$
Exemple: "b8f1c2e0-6f7a-4d2e-9c1b-2a3d4e5f6a7b"

Réponses

201

Créé.

dataobligatoire
object
Champs de data
message
object

La réponse publiée.

Champs de message
id
integer
Exemple: 8012
author
object

L'utilisateur de l'équipe agissant qui a publié la réponse.

Champs de author
participant_id
integer | null
name
string | null
kind
string

staff = un membre de l'équipe du cabinet, client = le client externe.

Valeurs autorisées: "staff" "client"
direction
string

Toujours "from_firm" pour une réponse publiée via cette API.

Valeurs autorisées: "from_firm" "from_client"
body
string

Le message publié, en texte brut.

created_at
string <date-time> | null
portal
object

Le portail (fil) et son dossier dans lesquels la réponse a été publiée.

Champs de portal
id
integer
matter
object
Champs de matter
id
integer
case_number
string
created_via_api
object | null

Provenance du message créé via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: true
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éé.

dataobligatoire
object
Champs de data
message
object

La réponse publiée.

Champs de message
id
integer
Exemple: 8012
author
object

L'utilisateur de l'équipe agissant qui a publié la réponse.

Champs de author
participant_id
integer | null
name
string | null
kind
string

staff = un membre de l'équipe du cabinet, client = le client externe.

Valeurs autorisées: "staff" "client"
direction
string

Toujours "from_firm" pour une réponse publiée via cette API.

Valeurs autorisées: "from_firm" "from_client"
body
string

Le message publié, en texte brut.

created_at
string <date-time> | null
portal
object

Le portail (fil) et son dossier dans lesquels la réponse a été publiée.

Champs de portal
id
integer
matter
object
Champs de matter
id
integer
case_number
string
created_via_api
object | null

Provenance du message créé via cette API.

Champs de created_via_api
kind
string

"key" : créé avec une clé API statique ; "oauth" : créé par une application connectée via OAuth.

Valeurs autorisées: "key" "oauth"
key_id
integer

Id de la clé API (kind "key") ou de l'application connectée (kind "oauth") ; les deux sont numérotés séparément.

key_name
string

Nom 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_id
integer
user
string | null
at
string <date-time> | null
created
boolean
Valeur: false
idempotent_replay
boolean
Valeur: true
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é.

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.

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).

413

Le corps de la requête est trop volumineux (request_too_large).

422

Échec de la validation ou champ inconnu ; details.fields liste les erreurs par champ.

429

Limite de débit dépassée ; Retry-After indique quand réessayer.

503

Le cabinet est temporairement indisponible (maintenance ou configuration en cours) ; 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."
}'

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
}