Version 26.6.x (21/07/2026)
Quoi de neuf dans cette version ?
Nouvelle version majeure de la Review
Une nouvelle version majeure de la Review est disponible ! Bien plus qu'un écran de vidéo codage, cette nouvelle mouture vous permet de configurer intégralement les écrans de correction, de gérer des Files avec des délais et des SLA de réalisation, de gérer des utilisateurs correcteurs et experts avec des droits d'accès spécifiques.
Fichiers de Ressources globaux
Les fichiers de Ressources deviennent globaux et sont désormais accessibles à tous les Services, et plus uniquement aux Workflows. La Review peut donc accéder aux fichiers Ressources et proposer par exemple des auto complétion dans les champs de correction.
Champs State et Status
Les champs State et Status des Workflows sont clarifiés. Le champ State est un champ utilisateur, qui peut être exploité pour suivre l'avancement d'un workflow selon des étapes propres au cas d'usage. Le champ Status est un champ système, utilisé par la Suite uniquement, et qui prend désormais l'une des valeurs suivantes : start, running, pending, success et failure.
Points d'attention
Points d'attentionAPI Ressources
Les Ressources sont désormais remontées au niveau de l'Organisation et plus du Workflow, ce qui implique un changement des API qui les exploitent.
Les anciennes API sont désormais marquées deprecated dans le Swagger ainsi que dans les en-têtes HTTP.
Nous vous invitons donc à mettre à jour les parties de votre code qui réalisent les appels aux API Ressources (https://extract.workflow.recital.ai/workflows/api/v1/resources/files/).
Les nouveaux appels API auront la forme https://extract.auth.recital.ai/auth/api/v1/resources/.
Pour information, les appels vers l'ancienne URL seront fonctionnels jusqu'au 31/12/2026 mais n'existeront plus après.
Champs State et Status
Comme expliqué plus haut, les champs State et Status changent de sémantique. Assurez-vous notamment que vous n'utilisez pas le champ Status dans vos workflows car ce dernier étant un champ système utilisé par la plateforme, il pourra être modifié durant l'exécution du workflow.
Si vous utilisez Status, remplacez-le par State.
End points API
Fichiers ressources
Comme indiqué plus haut il faut remplacer les route API Ressources
AVANT : https://extract.workflow.recital.ai/workflows/api/v1/resources/files/
APRÈS : https://extract.auth.recital.ai/auth/api/v1/resources/files/
Authenticator
/auth/api/v1/resources/extensions/ (GET)
Absente
Disponible
Récupération de la liste des extensions de fichiers supportées.
/auth/api/v1/resources/folders/ (GET, POST, DELETE)
Absente
Disponible
Gestion des répertoires de stockage.
- Query (GET) : folder (string, optionnel)
- Body (POST) : FolderIn (path requis)
- Query (DELETE) : path (string, requis)
/auth/api/v1/resources/folders/rename/ (POST)
Absente
Disponible
Renommage d'un dossier.
- Query : path (string, requis)
- Body : ResourceRename (name requis)
/auth/api/v1/resources/folders/bulk/ (DELETE)
Absente
Disponible
Suppression groupée de dossiers.
- Body : ResourcesToDelete (paths requis)
/auth/api/v1/resources/files/ (GET, POST, PUT, DELETE)
Absente
Disponible
Gestion des fichiers (liste, upload, modification, suppression).
- Query (GET/POST) : folder (string, optionnel)
- Body (POST) : file_in (binary, requis)
- Query (PUT/DELETE) : path (string, requis)
/auth/api/v1/resources/files/content/ (GET)
Absente
Disponible
Récupération du contenu binaire d'un fichier.
- Query : path (string, requis)
/auth/api/v1/resources/files/blank/ (POST)
Absente
Disponible
Génération d'un fichier vide.
- Query : path (string, requis)
/auth/api/v1/resources/files/rename/ (POST)
Absente
Disponible
Renommage d'un fichier.
- Query : path (string, requis)
- Body : ResourceRename (name requis)
/auth/api/v1/resources/files/move/ (POST)
Absente
Disponible
Déplacement d'un fichier vers un autre dossier.
- Query : path (string, requis)
- Body : ResourceMove (target_folder optionnel)
/auth/api/v1/resources/files/bulk/ (DELETE)
Absente
Disponible
Suppression groupée de fichiers.
- Body : ResourcesToDelete (paths requis)
Schémas d'utilisateurs (UserCreate, UserOut, GroupUserOut, etc.)
Langue par défaut : "en" (Anglais)
Langue par défaut : "fr" (Français)
La langue par défaut de l'utilisateur (UserLanguage) est passée de l'anglais au français dans les différents schémas de l'API.
3) Tableau comparatif des routes et paramètres (Workflows)
Attention: si vous utilisiez ces attributs d’étape dans vos blocs de code des Workflow, alors il faudra les modifier dans vos codes avec la nouvelle version :
Les attributs d’étape status initial et final ont été supprimés.
Exemple:
AVANT:
APRES:
Le cycle de vie du job est désormais explicite dans l’attribut status, avec un nombre très limité de statuts possibles:
La gestion des erreurs, signalée par l'échec (failure), est désormais explicite.
Des événements dédiés de démarrage (start), de succès (success) et d’échec (failure) sont désormais déclenchés à un niveau inférieur.
Les pseudo-états (auparavant utilisés pour signaler des erreurs) ont été supprimés.
Les étapes d’état (state steps) se contentent désormais de modifier le champ state et peuvent provoquer l’échec du travail si elles sont configurées à cet effet.
Le champ state est une valeur technique utilisée pour le signalement et le requêtage des travaux.
GET /workflows/api/v1/jobs/
Paramètre status absent.
Disponible
Ajout d'un filtre sur l'état général du travail.
- Query : status (string, optionnel)
POST /workflows/api/v1/jobs/
Paramètre references absent.
Disponible
Ajout d'une option de liaison ou de référencement externe pour le travail.
- Query : references (string, optionnel)
GET /workflows/api/v1/workflows/by-uuid
Existant
Existant (avec paramètre query additionnel)
Ajout de paramètre : Ajout du paramètre optionnel archived (type : boolean , par défaut false ) pour filtrer ou inclure les architectures de workflows archivées.
Schéma de réponse : JobResponse & JobResponseWithData
Schéma standard sans suivi de durée ni horodatages fins.
Modélisation enrichie
Ajout d'indicateurs de performance et de cycle de vie.
- Property : started_at (string, format date-time)
- Property : success_at (string, format date-time)
- Property : error_at (string, format date-time)
- Property : duration (number, durée en secondes)
- Property : status (string, enum : created, running, success, failure)
Schéma de réponse : JobEntry
Propriété duration absente.
Disponible
Ajout du suivi de performance pour chaque entrée historique de tâche. - Property : duration (number ou null)
Schéma de réponse : JobStatus
Propriété existante .
Disponible
Nouveau schéma de type énumération contenant les valeurs : ["created", "running", "success", "failure"].
Schémas d'étapes : StepRequest, StepPartialRequest & StepResponse
Présence des drapeaux de début et de fin de cycle d'étapes.
Flags retirés
Suppression complète des propriétés définissant le caractère d'entrée ou de sortie des étapes.
- Property : initial (boolean)
- Property : final (boolean)
Déclencheurs : Webhooks
Seul l'événement générique state:change était défini via le schéma WorkflowsWebhookPayload.
Spécification typée et nouveaux événements
Nouveaux déclencheurs Webhooks : Intégration de quatre webhooks natifs pour notifier le système externe des événements majeurs : • Workflow Job / start • Workflow Job / success • Workflow Job / failure • Workflow Job / custom (pour les étapes de script webhook personnalisées).
Routes d'API de ressources /workflows/api/v1/resources/... (Gestion de fichiers & dossiers)
Actives et classées sous les tags Resource Folders et Resource Files
Marquées comme obsolètes (deprecated: true ) sous le tag Resources (Deprecated)
Dépréciation globale : L'ensemble des endpoints de stockage et de manipulation de fichiers de ressources internes est déprécié.
Refonte des payloads de Webhooks
Les anciens schémas complexes préfixés (ex.
WorkflowsWebhookPayload,WorkflowsWebhookPayloadJob, etc.) ont été simplifiés et remplacés par des schémas standardisés :JobStartWebhook,JobSuccessWebhook,JobFailureWebhook,JobCustomWebhook,JobStateChangeWebhook.WebhookPayloadEvent,WebhookPayloadJob,WebhookPayloadStep,WebhookPayloadWorkflow.
4) Tableau comparatif des routes et paramètres (Extract)
DELETE /extract/api/v1/system_2/extract_path/{ext_path_id}
Existant
❌ Supprimé
Endpoint retiré : L'opération de suppression d'un chemin d'extraction pour System 2 n'est plus disponible sur cette route.
POST /extract/api/v1/files/
Existant (sans paramètre query)
Existant (avec paramètre query)
Modification de paramètres : Ajout du paramètre de requête optionnel reference (type : string) permettant de spécifier une référence à la création du fichier.
POST /extract/api/v1/production/files/
Existant (avec query params workflow_id et workflow_uuid)
Existant (avec query param reference uniquement)
Modification de paramètres : Les paramètres query workflow_id (integer) et workflow_uuid (string) ont été retirés au profit d'un paramètre query unique et optionnel nommé reference (string).
5) Tableau comparatif des routes et paramètres (Classify)
Enum / Schéma : ValueType
Uniquement 6 types de données supportés : unspecified, date, integer, float, regex, string.
Extension du support
Élargissement des types de valeurs exploitables pour les modèles de classification.
- Property : datetime - Property : time
Enum / Schéma : NormalizedValueType
Uniquement 4 types de normalisation disponibles : string, datetime, integer, float.
Extension du support
Ajout de formats de dates et de temps fins pour les valeurs normalisées.
- Property : date
- Property : time
Schéma de requête : DocumentUpdate
La propriété breaks (servant à la découpe des pages d'un bundle) n'acceptait pas de valeur nulle.
Typage nullable
La propriété breaks est assouplie pour accepter une valeur nulle, ce qui permet de réinitialiser ou d'annuler les découpes appliquées.
- Property : breaks (array ou null)
POST /classify/api/v1/documents/
Contient les query params workflow_id et workflow_uuid
Inexistants (Supprimés)
Suppression de paramètres : Les query params workflow_id (integer) et workflow_uuid (string) ont été retirés de l'endpoint d'importation de documents.
Changelog
Version 26.6.X (2026-07-21)
NOUVELLES FEATURES
Infra
Ajout de Scaleway comme fournisseur de LLM
Annotation
Meilleure organisation des étiquettes dans l'interface utilisateur d'annotation
Extraction
Amélioration du processus de mise à jour des agents d'extraction
Possibilité de relancer les extractions génératives
Mise en place de workers dédiés aux tâches de LLM dans le service d'extraction
Ajout d'un raccourci pour passer à la page suivante du fichier en cours dans l'écran de validation et de révision de l'agent d'extraction
Unification du processus de création des agents d'extraction
Possibilité de créer un agent d'extraction à partir d'agents d'extraction existants
Ajout de la prise en charge des expressions régulières de groupe (group regex) dans l'interface utilisateur
Review
Autocomplete dans la review
Prise en charge de la suppression de pages dans la liseuse de documents
Configuration de la review :
Ajout d'un onglet d'importation de mises en page ODS dans l'éditeur de file d'attente
Ajout d'une liseuse et d'un éditeur de feuilles de calcul prenant en charge les ressources ODS, XLSX, XLS et CSV
Tableaux
Nouvelle méthode d'agrégation de lignes
Scission des entités lorsqu'elles chevauchent plusieurs cellules de tableau
Possibilité de corriger une colonne entière d'un seul coup ? Possibilité de trier les colonnes du tableau de distribution des labels
Ressources
Ajout d'une section « Ressources » autonome adossée au système de stockage d'authenticator
Ajout de la carte « Ressources » dans la section Studio de l'accueil
Workflows
Ajout de la prise en charge des PDF préfixés par des métadonnées IMSP dans le moteur de traitement automatique
Introduction des types « Date » et « Heure » pour les extracteurs
Possibilité d'importer plusieurs fichiers simultanément lors des tests de workflow
Gestion des pièces jointes en double dans l'action d'importation d'e-mails
Autorisation du passage des variables d'environnement de proxy dans les étapes de code de workflow ? Mise à jour des politiques de rétention des tâches de workflow ? Amélioration de la gestion du cycle de vie des jobs
API
Suppression du champ d'orientation paysage (landscape) d'EntryPage et de FileRepresentation
Encapsulation du payload HTTP de l'étape Webhook dans une enveloppe webhook dédiée et mise à jour de sa documentation
API backend pour créer des agents d'extraction à partir d'agents d'extraction existants
Last updated