> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/api-reference/doc-api/fiches.md).

# Fiches

Créer, lire, mettre à jour, supprimer et rechercher des fiches

## GET /{app\_short}/submissions/assigned/me

> Lister les fiches assignées à l'utilisateur authentifié

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"Pagination":{"description":"Enveloppe commune à toutes les collections paginées, envoyée à côté de la collection elle-même.","properties":{"server_time":{"description":"Horodatage du serveur au moment de la construction de la réponse.","type":"integer"},"total_count":{"description":"Nombre total d'éléments correspondant à la requête, toutes pages confondues.","type":"integer"},"total_pages":{"type":"integer"},"next_page":{"description":"Index de la page suivante. Absent sur la dernière.","type":"integer"}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/assigned/me":{"get":{"tags":["submissions"],"summary":"Lister les fiches assignées à l'utilisateur authentifié","operationId":"listAssignedSubmissions","parameters":[{"name":"page","in":"query","description":"Page de la vue d'ensemble.","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"0","pattern":"\\d+"}},{"name":"per_page","in":"query","description":"Nombre de résultats par page (max. 100)","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"10","pattern":"-?\\d+"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"Liste paginée des fiches assignées à l'utilisateur authentifié.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Pagination"},{"properties":{"submissions":{"type":"array","items":{"$ref":"#/components/schemas/Submission"}}},"type":"object"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"L'utilisateur n'a pas accès à ce vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Lister les fiches d'un formulaire

> Les résultats sont limités aux formulaires auxquels l'utilisateur authentifié a accès dans le vertical métier.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"Pagination":{"description":"Enveloppe commune à toutes les collections paginées, envoyée à côté de la collection elle-même.","properties":{"server_time":{"description":"Horodatage du serveur au moment de la construction de la réponse.","type":"integer"},"total_count":{"description":"Nombre total d'éléments correspondant à la requête, toutes pages confondues.","type":"integer"},"total_pages":{"type":"integer"},"next_page":{"description":"Index de la page suivante. Absent sur la dernière.","type":"integer"}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions":{"get":{"tags":["submissions"],"summary":"Lister les fiches d'un formulaire","description":"Les résultats sont limités aux formulaires auxquels l'utilisateur authentifié a accès dans le vertical métier.","operationId":"listSubmissions","parameters":[{"name":"structure_id","in":"query","description":"Identifiant du formulaire (obligatoire sauf si `reference=true`).","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"page","in":"query","description":"Page de la vue d'ensemble.","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"0","pattern":"\\d+"}},{"name":"per_page","in":"query","description":"Nombre de résultats par page (max. 100)","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"10","pattern":"-?\\d+"}},{"name":"reference","in":"query","description":"Récupérer les données de référence","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":null,"pattern":"true|false"}},{"name":"updated_since","in":"query","description":"Résultats modifiés depuis cette date","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"user_id","in":"query","description":"Filtrer par identifiant d'utilisateur","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"last_updated_user_id","in":"query","description":"Filtrer par identifiant du dernier utilisateur ayant modifié","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"items_expanded","in":"query","description":"Récupérer la liste complète des éléments ou de l'utilisateur","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"true|false"}},{"name":"expanded_types","in":"query","description":"définir les types d'éléments à développer","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"[a-z,]+"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"Liste paginée des fiches.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Pagination"},{"properties":{"submissions":{"type":"array","items":{"$ref":"#/components/schemas/Submission"}}},"type":"object"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"L'utilisateur n'a pas accès à ce vertical métier ou à ce formulaire.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Créer une fiche

> Pour les champs \`image\`, \`signature\` et \`file\`, envoyez d'abord le fichier et utilisez ici l'UUID retourné.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SubmissionInput":{"required":["structure_id","structure_version","items"],"properties":{"created_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"},"id":{"description":"Généré automatiquement par le serveur si omis","type":"string","format":"uuid"},"items":{"type":"object","additionalProperties":true},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"substitute_user_id":{"description":"Optionnel. Définit un autre utilisateur comme créateur/propriétaire. L'utilisateur authentifié est toujours tracé dans l'historique.","type":"integer"},"trigger_id":{"description":"Transition de workflow à appliquer (PUT/PATCH uniquement)","type":"string","format":"uuid"},"updated_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions":{"post":{"tags":["submissions"],"summary":"Créer une fiche","description":"Pour les champs `image`, `signature` et `file`, envoyez d'abord le fichier et utilisez ici l'UUID retourné.","operationId":"createSubmission","parameters":[{"name":"partial","in":"query","description":"Autoriser le mode partiel","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false","pattern":"true|false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionInput"}}}},"responses":{"200":{"description":"Fiche créée","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"400":{"description":"Le corps de la requête est invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## Rechercher des fiches

> Retourne les fiches correspondant à des critères au niveau des champs. Un champ ne peut apparaître\
> qu'une seule fois, et la casse des opérateurs est significative.\
> \
> \| Opérateur | Types de champs compatibles |\
> \|---|---|\
> \| \`equal\` / \`notequal\` | texte, nombre, booléen, date, email, téléphone |\
> \| \`isNull\` / \`isNotNull\` | tous |\
> \| \`less\` / \`greater\` / \`lesseq\` / \`greatereq\` | nombre |\
> \| \`contains\` / \`notContains\` / \`startWith\` / \`endWith\` | texte, email, téléphone |\
> \| \`in\` | liste, utilisateur, texte |\
> \| \`range\` | nombre, date |

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SearchCriteria":{"description":"Objet dont chaque clé est un nom système de champ valide. Respectez la casse des opérateurs.","type":"object","additionalProperties":{"required":["operator"],"properties":{"operator":{"type":"string","enum":["equal","notequal","isNull","isNotNull","less","greater","lesseq","greatereq","contains","notContains","startWith","endWith","in","range"]},"value":{"description":"Valeur recherchée (à omettre pour isNull / isNotNull)"}},"type":"object"}},"SubmissionListResponse":{"properties":{"server_time":{"type":"integer","format":"int64"},"submissions":{"type":"array","items":{"$ref":"#/components/schemas/Submission"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/search":{"post":{"tags":["submissions"],"summary":"Rechercher des fiches","description":"Retourne les fiches correspondant à des critères au niveau des champs. Un champ ne peut apparaître\nqu'une seule fois, et la casse des opérateurs est significative.\n\n| Opérateur | Types de champs compatibles |\n|---|---|\n| `equal` / `notequal` | texte, nombre, booléen, date, email, téléphone |\n| `isNull` / `isNotNull` | tous |\n| `less` / `greater` / `lesseq` / `greatereq` | nombre |\n| `contains` / `notContains` / `startWith` / `endWith` | texte, email, téléphone |\n| `in` | liste, utilisateur, texte |\n| `range` | nombre, date |","operationId":"searchSubmissions","parameters":[{"name":"structure_id","in":"query","description":"Identifiant du formulaire (obligatoire sauf si `reference=true`).","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"page","in":"query","description":"Page de la vue d'ensemble.","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"0","pattern":"\\d+"}},{"name":"per_page","in":"query","description":"Nombre de résultats par page (max. 1000)","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"10","pattern":"-?\\d+"}},{"name":"reference","in":"query","description":"Récupérer les données de référence","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":null,"pattern":"true|false"}},{"name":"updated_since","in":"query","description":"Résultats modifiés depuis cette date","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"user_id","in":"query","description":"Filtrer par identifiant d'utilisateur","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"last_updated_user_id","in":"query","description":"Filtrer par identifiant du dernier utilisateur ayant modifié","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"items_expanded","in":"query","description":"Récupérer la liste complète des éléments ou de l'utilisateur","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"true|false"}},{"name":"expanded_types","in":"query","description":"définir les types d'éléments à développer","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"[a-z,]+"}},{"name":"show_deleted_lists","in":"query","description":"Récupérer les éléments de liste même supprimés","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"true|false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCriteria"}}}},"responses":{"200":{"description":"Fiches correspondantes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionListResponse"}}}},"400":{"description":"Opérateur inconnu, ou incompatible avec le type du champ.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## GET /{app\_short}/submissions/{submission\_id}

> Récupérer une fiche

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/{submission_id}":{"get":{"tags":["submissions"],"summary":"Récupérer une fiche","operationId":"getSubmission","parameters":[{"name":"items_expanded","in":"query","description":"Récupérer la liste complète des éléments ou de l'utilisateur","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"true|false"}},{"name":"expanded_types","in":"query","description":"définir les types d'éléments à développer","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"[a-z,]+"}},{"name":"fields","in":"query","description":"Récupérer les champs additionnels","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\w+"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","pattern":"[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"La fiche demandée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"400":{"description":"L'identifiant n'est pas un UUID valide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Aucune fiche avec cet identifiant dans le vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Mettre à jour une fiche

> Remplace les données de la fiche. Sur un formulaire avec workflow, incluez \`trigger\_id\` pour faire avancer l'état. Une fiche se trouvant dans un état final ne peut plus être modifiée.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SubmissionInput":{"required":["structure_id","structure_version","items"],"properties":{"created_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"},"id":{"description":"Généré automatiquement par le serveur si omis","type":"string","format":"uuid"},"items":{"type":"object","additionalProperties":true},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"substitute_user_id":{"description":"Optionnel. Définit un autre utilisateur comme créateur/propriétaire. L'utilisateur authentifié est toujours tracé dans l'historique.","type":"integer"},"trigger_id":{"description":"Transition de workflow à appliquer (PUT/PATCH uniquement)","type":"string","format":"uuid"},"updated_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/{submission_id}":{"put":{"tags":["submissions"],"summary":"Mettre à jour une fiche","description":"Remplace les données de la fiche. Sur un formulaire avec workflow, incluez `trigger_id` pour faire avancer l'état. Une fiche se trouvant dans un état final ne peut plus être modifiée.","operationId":"updateSubmission","parameters":[{"name":"partial","in":"query","description":"Autoriser le mode partiel","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false","pattern":"true|false"}},{"name":"force_restore","in":"query","description":"Autorise l'application mobile à restaurer une fiche supprimée","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","pattern":"[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionInput"}}}},"responses":{"200":{"description":"Fiche mise à jour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"400":{"description":"Le corps de la requête est invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Aucune fiche avec cet identifiant dans le vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## DELETE /{app\_short}/submissions/{submission\_id}

> Supprimer une fiche

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}}},"paths":{"/{app_short}/submissions/{submission_id}":{"delete":{"tags":["submissions"],"summary":"Supprimer une fiche","operationId":"deleteSubmission","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","pattern":"[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"204":{"description":"Fiche supprimée"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Aucune fiche avec cet identifiant dans le vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Mettre à jour une fiche partiellement

> Seuls les \`items\` fournis sont mis à jour ; tous les autres champs restent inchangés.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SubmissionInput":{"required":["structure_id","structure_version","items"],"properties":{"created_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"},"id":{"description":"Généré automatiquement par le serveur si omis","type":"string","format":"uuid"},"items":{"type":"object","additionalProperties":true},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"substitute_user_id":{"description":"Optionnel. Définit un autre utilisateur comme créateur/propriétaire. L'utilisateur authentifié est toujours tracé dans l'historique.","type":"integer"},"trigger_id":{"description":"Transition de workflow à appliquer (PUT/PATCH uniquement)","type":"string","format":"uuid"},"updated_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/{submission_id}":{"patch":{"tags":["submissions"],"summary":"Mettre à jour une fiche partiellement","description":"Seuls les `items` fournis sont mis à jour ; tous les autres champs restent inchangés.","operationId":"patchSubmission","parameters":[{"name":"partial","in":"query","description":"Autoriser le mode partiel","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false","pattern":"true|false"}},{"name":"force_restore","in":"query","description":"Autorise l'application mobile à restaurer une fiche supprimée","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","pattern":"[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionInput"}}}},"responses":{"200":{"description":"Fiche complète mise à jour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"400":{"description":"Le corps de la requête est invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Aucune fiche avec cet identifiant dans le vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Créer plusieurs fiches (asynchrone)

> Interrogez \`callbackUrl\` pour connaître l'état d'avancement du traitement.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SubmissionInput":{"required":["structure_id","structure_version","items"],"properties":{"created_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"},"id":{"description":"Généré automatiquement par le serveur si omis","type":"string","format":"uuid"},"items":{"type":"object","additionalProperties":true},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"substitute_user_id":{"description":"Optionnel. Définit un autre utilisateur comme créateur/propriétaire. L'utilisateur authentifié est toujours tracé dans l'historique.","type":"integer"},"trigger_id":{"description":"Transition de workflow à appliquer (PUT/PATCH uniquement)","type":"string","format":"uuid"},"updated_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"}},"type":"object"},"CallbackUrlResponse":{"properties":{"callbackUrl":{"description":"URL à interroger pour suivre l'avancement du job asynchrone","type":"string"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/multiple":{"post":{"tags":["submissions"],"summary":"Créer plusieurs fiches (asynchrone)","description":"Interrogez `callbackUrl` pour connaître l'état d'avancement du traitement.","operationId":"createMultipleSubmissions","parameters":[{"name":"partial","in":"query","description":"Autoriser le mode partiel","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false","pattern":"true|false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubmissionInput"}}}}},"responses":{"200":{"description":"Job asynchrone accepté","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackUrlResponse"}}}},"400":{"description":"Corps de requête vide, ou plus de fiches que le maximum configuré.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## Mettre à jour plusieurs fiches (asynchrone)

> Interrogez \`callbackUrl\` pour connaître l'état d'avancement du traitement.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SubmissionInput":{"required":["structure_id","structure_version","items"],"properties":{"created_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"},"id":{"description":"Généré automatiquement par le serveur si omis","type":"string","format":"uuid"},"items":{"type":"object","additionalProperties":true},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"substitute_user_id":{"description":"Optionnel. Définit un autre utilisateur comme créateur/propriétaire. L'utilisateur authentifié est toujours tracé dans l'historique.","type":"integer"},"trigger_id":{"description":"Transition de workflow à appliquer (PUT/PATCH uniquement)","type":"string","format":"uuid"},"updated_at":{"description":"Date de dernière modification (défaut : maintenant)","type":"integer","format":"int64"}},"type":"object"},"CallbackUrlResponse":{"properties":{"callbackUrl":{"description":"URL à interroger pour suivre l'avancement du job asynchrone","type":"string"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/multiple":{"put":{"tags":["submissions"],"summary":"Mettre à jour plusieurs fiches (asynchrone)","description":"Interrogez `callbackUrl` pour connaître l'état d'avancement du traitement.","operationId":"updateMultipleSubmissions","parameters":[{"name":"partial","in":"query","description":"Autoriser le mode partiel","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false","pattern":"true|false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubmissionInput"}}}}},"responses":{"200":{"description":"Job asynchrone accepté","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackUrlResponse"}}}},"400":{"description":"Corps de requête vide, ou plus de fiches que le maximum configuré.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## Récupérer des fiches par identifiants

> Chaque identifiant peut porter optionnellement un filtre \`updated\_since\`.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/byids":{"post":{"tags":["submissions"],"summary":"Récupérer des fiches par identifiants","description":"Chaque identifiant peut porter optionnellement un filtre `updated_since`.","operationId":"getSubmissionsByIds","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["submission_ids"],"properties":{"submission_ids":{"type":"array","items":{"required":["id"],"properties":{"id":{"type":"string","format":"uuid"},"updated_since":{"description":"Ignorer cette fiche si elle n'a pas changé depuis cette date.","type":"integer"}},"type":"object"}}},"type":"object"}}}},"responses":{"200":{"description":"Fiches correspondantes","content":{"application/json":{"schema":{"properties":{"submissions":{"type":"array","items":{"$ref":"#/components/schemas/Submission"}}},"type":"object"}}}},"400":{"description":"Trop d'identifiants pour une seule requête.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## Envoyer un fichier pour une fiche

> Envoie un fichier à rattacher à un champ \`image\`, \`signature\` ou \`file\`. Utilisez l'\`uuid\` retourné dans ce champ.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"FileUploadResponse":{"properties":{"mime-type":{"type":"string"},"size":{"description":"Taille du fichier en octets","type":"integer"},"uuid":{"description":"Référencez cet UUID dans les champs de fiche de type image/signature/fichier","type":"string","format":"uuid"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/upload":{"post":{"tags":["submissions"],"summary":"Envoyer un fichier pour une fiche","description":"Envoie un fichier à rattacher à un champ `image`, `signature` ou `file`. Utilisez l'`uuid` retourné dans ce champ.","operationId":"uploadSubmissionFile","parameters":[{"name":"convertToPdf","in":"query","description":"Convertir le fichier envoyé en PDF","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"false","pattern":"true|false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Fichier envoyé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## POST /{app\_short}/submissions/upload/{submission\_id}/{file\_id}

> Envoyer un fichier avec des identifiants de fiche et de fichier explicites

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"FileUploadResponse":{"properties":{"mime-type":{"type":"string"},"size":{"description":"Taille du fichier en octets","type":"integer"},"uuid":{"description":"Référencez cet UUID dans les champs de fiche de type image/signature/fichier","type":"string","format":"uuid"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/upload/{submission_id}/{file_id}":{"post":{"tags":["submissions"],"summary":"Envoyer un fichier avec des identifiants de fiche et de fichier explicites","operationId":"uploadSubmissionFileWithIds","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Fichier envoyé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## GET /{app\_short}/submissions/{submission\_id}/file/{file\_id}

> Récupérer un fichier lié à une fiche

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}}},"paths":{"/{app_short}/submissions/{submission_id}/file/{file_id}":{"get":{"tags":["submissions"],"summary":"Récupérer un fichier lié à une fiche","operationId":"getSubmissionFile","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","pattern":"[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"Contenu binaire du fichier","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Aucune fiche avec cet identifiant dans le vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## GET /{app\_short}/submissions/multiple/callback/{callback\_id}

> Interroger un traitement de fiches asynchrone

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submissions"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"SubmissionCallbackResponse":{"properties":{"callbackDetails":{"properties":{"errors":{"type":"array","items":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"nbErrors":{"type":"integer"},"nbRecordsDone":{"type":"integer"},"nbRecordsTodo":{"type":"integer"},"nbSuccess":{"type":"integer"},"status":{"type":"string","enum":["Planned","Running","Finished","Finished with errors","Failed","In timeout"]},"success":{"type":"array","items":{"type":"string","format":"uuid"}}},"type":"object"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/submissions/multiple/callback/{callback_id}":{"get":{"tags":["submissions"],"summary":"Interroger un traitement de fiches asynchrone","operationId":"getMultipleSubmissionsCallback","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"callback_id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"Statut et détails du job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionCallbackResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.center.daxium-air.com/api-reference/doc-api/fiches.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.