> For the complete documentation index, see [llms.txt](https://docs.recital.ai/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.recital.ai/products/changelogs/version-26.6.x-xx-0x-2026.md).

# Version 26.6.x (xx/0x/2026)

## ENDPOINTS API

#### 1) Endpoint fichiers ressources:

*<mark style="color:$danger;">**Attention: si vous utilisiez ces routes pour accéder aux fichiers ressources dans vos blocs de code des Workflow, alors il faudra les modifier dans vos codes avec la nouvelle version :**</mark>*&#x20;

***AVANT :***&#x20;

<https://extract.workflow.recital.ai/workflows/api/v1/resources/files/>&#x20;

***APRES :***&#x20;

<https://extract.auth.recital.ai/auth/api/v1/resources/files/>&#x20;

#### 2) Tableau comparatif des routes et paramètres (Authentification)

<table><thead><tr><th width="275">Endpoints de https://extract.auth.recital.ai</th><th width="116">Avant (v26.4.14)</th><th width="119">Après (v26.6)</th><th>Description / Paramètres</th></tr></thead><tbody><tr><td>/auth/api/v1/repositories/{repository_id}/blueprints/sync <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Synchronisation des blueprints d'un dépôt.</p><p>- Path : repository_id (integer)</p></td></tr><tr><td>/auth/api/v1/repositories/{repository_id}/blueprints/{blueprint_id}/install <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Installation d'un blueprint.</p><p>- Path : repository_id (integer), blueprint_id (integer)</p><p>- Query : new_name (string, optionnel)</p></td></tr><tr><td>/auth/api/v1/resources/extensions/ <strong>(GET)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td>Récupération de la liste des extensions de fichiers supportées.</td></tr><tr><td>/auth/api/v1/resources/folders/ <strong>(GET, POST, DELETE)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Gestion des répertoires de stockage.</p><p>- Query (GET) : folder (string, optionnel)</p><p>- Body (POST) : FolderIn (path requis)</p><p>- Query (DELETE) : path (string, requis)</p></td></tr><tr><td>/auth/api/v1/resources/folders/rename/ <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Renommage d'un dossier.</p><p>- Query : path (string, requis)</p><p>- Body : ResourceRename (name requis)</p></td></tr><tr><td>/auth/api/v1/resources/folders/bulk/ <strong>(DELETE)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Suppression groupée de dossiers.</p><p>- Body : ResourcesToDelete (paths requis)</p></td></tr><tr><td>/auth/api/v1/resources/files/ <strong>(GET, POST, PUT, DELETE)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Gestion des fichiers (liste, upload, modification, suppression).</p><p>- Query (GET/POST) : folder (string, optionnel)</p><p>- Body (POST) : file_in (binary, requis)</p><p>- Query (PUT/DELETE) : path (string, requis)</p></td></tr><tr><td>/auth/api/v1/resources/files/content/ <strong>(GET)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Récupération du contenu binaire d'un fichier.</p><p>- Query : path (string, requis)</p></td></tr><tr><td>/auth/api/v1/resources/files/blank/ <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Génération d'un fichier vide.</p><p>- Query : path (string, requis)</p></td></tr><tr><td>/auth/api/v1/resources/files/rename/ <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Renommage d'un fichier.</p><p>- Query : path (string, requis)</p><p>- Body : ResourceRename (name requis)</p></td></tr><tr><td>/auth/api/v1/resources/files/move/ <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Déplacement d'un fichier vers un autre dossier.</p><p>- Query : path (string, requis)</p><p>- Body : ResourceMove (target_folder optionnel)</p></td></tr><tr><td>/auth/api/v1/resources/files/bulk/ <strong>(DELETE)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Suppression groupée de fichiers.</p><p>- Body : ResourcesToDelete (paths requis)</p></td></tr><tr><td>/auth/api/v1/spreadsheet/convert <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Conversion d'un fichier tableur.</p><p>- Body : file (binary, requis)</p></td></tr><tr><td>/auth/api/v1/spreadsheet/save <strong>(POST)</strong></td><td>Absente</td><td><strong>Disponible</strong></td><td><p>Sauvegarde d'un tableur.</p><p>- Query : filename (string, requis)</p></td></tr><tr><td>/auth/api/v1/repositories/{repository_id}/blueprints/ <strong>(POST)</strong></td><td>Schéma BlueprintCreate classique</td><td>Modèle de blueprint restructuré (Spécification OCI)</td><td><p><strong>Avant :</strong> Métadonnées standards (meta_display_name, meta_description, meta_maintainer_name) et BlueprintObjectReference nécessitant service, type, export_path (9 types autorisés).</p><p></p><p><strong>Après :</strong> Réorganisé autour du standard OCI (org.opencontainers.image.* et vnd.blueprint.size). Objets restreints à 2 valeurs (emails_dataset et documents_dataset) ne requérant que product et type.</p></td></tr><tr><td>/auth/api/v1/repositories/ <strong>(POST)</strong></td><td>Port obligatoire dans RepositoryCreate</td><td>Port optionnel dans RepositoryCreate</td><td>Le champ port (type integer) était obligatoire pour la création. Il accepte désormais la valeur nulle (integer ou null) et n'est plus requis dans le schéma.</td></tr><tr><td>Schémas d'utilisateurs (UserCreate, UserOut, GroupUserOut, etc.)</td><td>Langue par défaut : "en" (Anglais)</td><td>Langue par défaut : "fr" (Français)</td><td>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.</td></tr></tbody></table>

#### 3) Tableau comparatif des routes et paramètres (Workflows)

*<mark style="color:$danger;">**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 :**</mark>*&#x20;

* <mark style="color:$danger;">Les attributs d’étape</mark> <mark style="color:$danger;"></mark>*<mark style="color:$danger;">**status**</mark>* *<mark style="color:$danger;">**initial**</mark>* <mark style="color:$danger;"></mark><mark style="color:$danger;">et</mark> <mark style="color:$danger;"></mark>*<mark style="color:$danger;">**final**</mark>* <mark style="color:$danger;"></mark><mark style="color:$danger;">ont été supprimés.</mark>
* <mark style="color:$danger;">Le cycle de vie du travail (job) est désormais explicite dans l’attribut status, avec un nombre très limité de statuts possibles:</mark>
  * <mark style="color:$danger;">La gestion des erreurs, signalée par l'échec (</mark>*<mark style="color:$danger;">**failure**</mark>*<mark style="color:$danger;">), est désormais explicite.</mark>
  * <mark style="color:$danger;">Des événements dédiés de démarrage (</mark>*<mark style="color:$danger;">**start**</mark>*<mark style="color:$danger;">), de succès (</mark>*<mark style="color:$danger;">**success**</mark>*<mark style="color:$danger;">) et d’échec (</mark>*<mark style="color:$danger;">**failure**</mark>*<mark style="color:$danger;">) sont désormais déclenchés à un niveau inférieur.</mark>
* <mark style="color:$danger;">Les pseudo-états (auparavant utilisés pour signaler des erreurs) ont été supprimés.</mark>
* <mark style="color:$danger;">Les étapes d’état (</mark>*<mark style="color:$danger;">**state steps**</mark>*<mark style="color:$danger;">) se contentent désormais de modifier le champ state et peuvent provoquer l’échec du travail si elles sont configurées à cet effet.</mark>
  * <mark style="color:$danger;">Le champ state est une valeur technique utilisée pour le signalement et le requêtage des travaux.</mark>

| Endpoints de <https://extract.workflows.recital.ai>               | Avant (v26.4.14)                                                                            | Après (v26.6)                                  | Description / Paramètres                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET /workflows/api/v1/jobs/                                       | Paramètre status absent.                                                                    | **Disponible**                                 | <p>Ajout d'un filtre sur l'état général du travail. </p><p>- Query : status (string, optionnel)</p>                                                                                                                                                                                                                                                                                                                                                     |
| POST /workflows/api/v1/jobs/                                      | Paramètre references absent.                                                                | **Disponible**                                 | <p>Ajout d'une option de liaison ou de référencement externe pour le travail. </p><p>- Query : references (string, optionnel)</p>                                                                                                                                                                                                                                                                                                                       |
| Schéma de réponse : JobResponse & JobResponseWithData             | Schéma standard sans suivi de durée ni horodatages fins.                                    | **Modélisation enrichie**                      | <p>Ajout d'indicateurs de performance et de cycle de vie. </p><p>- Property : started\_at (string, format date-time) </p><p>- Property : success\_at (string, format date-time) </p><p>- Property : error\_at (string, format date-time) </p><p>- Property : duration (number, durée en secondes) </p><p>- Property : status (string, enum : created, running, success, failure)</p>                                                                    |
| 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émas d'étapes : StepRequest, StepPartialRequest & StepResponse | Présence des drapeaux de début et de fin de cycle d'étapes.                                 | **Flags retirés**                              | <p>Suppression complète des propriétés définissant le caractère d'entrée ou de sortie des étapes. </p><p>- Property : initial (boolean) </p><p>- Property : final (boolean)</p>                                                                                                                                                                                                                                                                         |
| 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** | <p>Ajout et découpage de points d'accroche spécifiques avec des payloads fortement typés selon le cycle de vie du travail. </p><p>- Webhook : Workflow Job / start (JobStartWebhook) </p><p>- Webhook : Workflow Job / success (JobSuccessWebhook) </p><p>- Webhook : Workflow Job / failure (JobFailureWebhook) </p><p>- Webhook : Workflow Job / custom (JobCustomWebhook) </p><p>- Webhook : Workflow Job / state:change (JobStateChangeWebhook)</p> |

#### 4) Tableau comparatif des routes et paramètres (Extract)

| Endpoints de <https://extract.api.recital.ai> | Avant (v26.4.14)                                                                          | Après (v26.6)            | Description / Paramètres                                                                                                     |
| --------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **Enum / Schéma** : ValueType                 | Uniquement 6 types de données supportés : specified, date, integer, float, regex, string. | **Extension du support** | <p>Élargissement des types de valeurs exploitables pour les extracteurs. </p><p>- Property : datetime - Property : time</p>  |
| **Enum / Schéma** : NormalizedValueType       | Uniquement 4 types de normalisation disponibles : string, datetime, integer, float.       | **Extension du support** | <p>Ajout de formats de dates et de temps fins pour les normalisations. </p><p>- Property : date </p><p>- Property : time</p> |
| **Schéma de réponse** : PageOut               | Le schéma de sortie intègre un champ requis d'orientation pour la page.                   | **Propriété retirée**    | <p>Retrait complet du paramètre d'orientation automatique de l'objet de réponse. </p><p>- Property : landscape (boolean)</p> |

#### 5) Tableau comparatif des routes et paramètres (Classify)

| Endpoints de <https://extract.classify.recital.ai> | Avant (v26.4.14)                                                                                  | Après (v26.6)            | Description / Paramètres                                                                                                                                                                 |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enum / Schéma** : ValueType                      | Uniquement 6 types de données supportés : unspecified, date, integer, float, regex, string.       | **Extension du support** | <p>Élargissement des types de valeurs exploitables pour les modèles de classification. </p><p>- Property : datetime - Property : time</p>                                                |
| **Enum / Schéma** : NormalizedValueType            | Uniquement 4 types de normalisation disponibles : string, datetime, integer, float.               | **Extension du support** | <p>Ajout de formats de dates et de temps fins pour les valeurs normalisées. </p><p>- Property : date </p><p>- Property : time</p>                                                        |
| **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**      | <p>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. </p><p>- Property : breaks (array ou null)</p> |

### 26.6.1 (2026-0x-x)

#### Nouvelles fonctionnalités

#### Corrections de bugs


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.recital.ai/products/changelogs/version-26.6.x-xx-0x-2026.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.