# Formulaires

## Lister tous les formulaires

> Retourne tous les formulaires disponibles avec pagination.

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"structures"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"StructureListResponse":{"type":"object","properties":{"structures":{"type":"array","items":{"$ref":"#/components/schemas/Structure"},"description":"Liste des formulaires"},"total_count":{"type":"integer","description":"Nombre total de formulaires"},"total_pages":{"type":"integer","description":"Nombre total de pages"},"next_page":{"type":"integer","description":"Numéro de la page suivante"},"server_time":{"type":"integer","format":"int64","description":"Date courante du serveur (timestamp UNIX)"},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/Workflow"},"description":"Workflows utilisés dans ces formulaires"},"required":{"type":"object","description":"Formulaires et listes liés aux résultats","properties":{"linked_list_ids":{"type":"array","items":{"type":"integer"}},"structure_ids":{"type":"array","items":{"type":"integer"}}}}}},"Structure":{"type":"object","properties":{"id":{"type":"integer","description":"Identifiant du formulaire"},"version":{"type":"integer","description":"Numéro de version"},"name":{"type":"string","description":"Nom affiché"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"settings":{"type":"object","additionalProperties":true,"description":"Paramètres du formulaire"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"},"description":"Liste des conditions"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Field"},"description":"Liste des champs"},"layout":{"type":"object","description":"Pages et positions des champs","properties":{"pages":{"type":"array","items":{}},"fields":{"type":"array","items":{}}}},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/Workflow"},"description":"Workflows du formulaire (si présents)"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/Trigger"},"description":"Personnalisation des transitions du workflow"}}},"Condition":{"type":"object","description":"Condition de visibilité d'un champ","properties":{"uuid":{"type":"string","format":"uuid","description":"Identifiant de la condition"},"name":{"type":"string","description":"Nom de la condition"},"cdt":{"type":"string","description":"Condition au format JavaScript"},"fields":{"type":"array","items":{"type":"string"},"description":"Champs utilisés dans la condition"},"json_format":{"type":"array","description":"Condition au format JSON","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":"string"},"operator":{"type":"string"}}}}}},"Field":{"type":"object","description":"Définition d'un champ de formulaire","properties":{"name":{"type":"string","description":"Nom système du champ — utilisé comme clé dans les `items` d'une fiche"},"label":{"type":"string","description":"Nom affiché"},"position":{"type":"integer","description":"Position dans le formulaire"},"type":{"type":"string","description":"Type de champ : text, number, boolean, date, duration, phone, email, location, image, signature, file, list, relation, user, label…\n"},"enable":{"type":"boolean","description":"Champ activé ou non"},"required":{"type":"boolean","description":"Champ requis ou non"},"prefill":{"type":"boolean","description":"Peut être pré-rempli sur le mobile"},"readonly":{"type":"boolean","description":"Non modifiable sur le mobile"},"searchable":{"type":"boolean","description":"Peut être utilisé dans la recherche"}}},"Workflow":{"type":"object","description":"Workflow d'un formulaire","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","description":"Nom du workflow"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"start_state":{"type":"string","format":"uuid","description":"État initial du workflow"},"states":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowState"},"description":"Liste des états"},"transitions":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowTransition"},"description":"Liste des transitions"}}},"WorkflowState":{"type":"object","description":"État d'un workflow","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","description":"Nom affiché"},"color":{"type":"string","description":"Couleur hexadécimale (ex. `#FF9800`)"},"end":{"type":"boolean","description":"Si vrai, les fiches dans cet état ne peuvent plus être modifiées"}}},"WorkflowTransition":{"type":"object","description":"Transition entre deux états","properties":{"id":{"type":"string","format":"uuid"},"from":{"type":"string","format":"uuid","description":"État source"},"to":{"type":"string","format":"uuid","description":"État cible"},"label":{"type":"string","description":"Libellé de la transition"}}},"Trigger":{"type":"object","description":"Personnalise l'apparence d'une transition de workflow sous forme de bouton","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"transition_id":{"type":"string","format":"uuid","description":"Identifiant de la transition associée"},"color":{"type":"string","description":"Couleur du bouton"},"label":{"type":"string","description":"Libellé du bouton"}}}}},"paths":{"/{app_short}/structures":{"get":{"summary":"Lister tous les formulaires","description":"Retourne tous les formulaires disponibles avec pagination.","tags":["structures"],"operationId":"listStructures","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"per_page","in":"query","description":"Nombre de formulaires par page (défaut 10)","schema":{"type":"integer","default":10}},{"name":"page","in":"query","description":"Numéro de page (base 0)","schema":{"type":"integer","default":0}},{"name":"updated_since","in":"query","description":"Ne retourner que les formulaires mis à jour depuis ce timestamp UNIX","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Liste paginée de formulaires","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StructureListResponse"}}}}}}}}}
```

## Récupérer un formulaire

> Retourne le formulaire à la version indiquée, ou la dernière version si omise.

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"structures"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"Structure":{"type":"object","properties":{"id":{"type":"integer","description":"Identifiant du formulaire"},"version":{"type":"integer","description":"Numéro de version"},"name":{"type":"string","description":"Nom affiché"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"settings":{"type":"object","additionalProperties":true,"description":"Paramètres du formulaire"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"},"description":"Liste des conditions"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Field"},"description":"Liste des champs"},"layout":{"type":"object","description":"Pages et positions des champs","properties":{"pages":{"type":"array","items":{}},"fields":{"type":"array","items":{}}}},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/Workflow"},"description":"Workflows du formulaire (si présents)"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/Trigger"},"description":"Personnalisation des transitions du workflow"}}},"Condition":{"type":"object","description":"Condition de visibilité d'un champ","properties":{"uuid":{"type":"string","format":"uuid","description":"Identifiant de la condition"},"name":{"type":"string","description":"Nom de la condition"},"cdt":{"type":"string","description":"Condition au format JavaScript"},"fields":{"type":"array","items":{"type":"string"},"description":"Champs utilisés dans la condition"},"json_format":{"type":"array","description":"Condition au format JSON","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":"string"},"operator":{"type":"string"}}}}}},"Field":{"type":"object","description":"Définition d'un champ de formulaire","properties":{"name":{"type":"string","description":"Nom système du champ — utilisé comme clé dans les `items` d'une fiche"},"label":{"type":"string","description":"Nom affiché"},"position":{"type":"integer","description":"Position dans le formulaire"},"type":{"type":"string","description":"Type de champ : text, number, boolean, date, duration, phone, email, location, image, signature, file, list, relation, user, label…\n"},"enable":{"type":"boolean","description":"Champ activé ou non"},"required":{"type":"boolean","description":"Champ requis ou non"},"prefill":{"type":"boolean","description":"Peut être pré-rempli sur le mobile"},"readonly":{"type":"boolean","description":"Non modifiable sur le mobile"},"searchable":{"type":"boolean","description":"Peut être utilisé dans la recherche"}}},"Workflow":{"type":"object","description":"Workflow d'un formulaire","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","description":"Nom du workflow"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"start_state":{"type":"string","format":"uuid","description":"État initial du workflow"},"states":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowState"},"description":"Liste des états"},"transitions":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowTransition"},"description":"Liste des transitions"}}},"WorkflowState":{"type":"object","description":"État d'un workflow","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","description":"Nom affiché"},"color":{"type":"string","description":"Couleur hexadécimale (ex. `#FF9800`)"},"end":{"type":"boolean","description":"Si vrai, les fiches dans cet état ne peuvent plus être modifiées"}}},"WorkflowTransition":{"type":"object","description":"Transition entre deux états","properties":{"id":{"type":"string","format":"uuid"},"from":{"type":"string","format":"uuid","description":"État source"},"to":{"type":"string","format":"uuid","description":"État cible"},"label":{"type":"string","description":"Libellé de la transition"}}},"Trigger":{"type":"object","description":"Personnalise l'apparence d'une transition de workflow sous forme de bouton","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"transition_id":{"type":"string","format":"uuid","description":"Identifiant de la transition associée"},"color":{"type":"string","description":"Couleur du bouton"},"label":{"type":"string","description":"Libellé du bouton"}}}}},"paths":{"/{app_short}/structures/{id}":{"get":{"summary":"Récupérer un formulaire","description":"Retourne le formulaire à la version indiquée, ou la dernière version si omise.","tags":["structures"],"operationId":"getStructure","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant du formulaire","schema":{"type":"integer"}},{"name":"version","in":"query","description":"Numéro de version du formulaire","schema":{"type":"integer"}}],"responses":{"200":{"description":"Objet formulaire","content":{"application/json":{"schema":{"type":"object","properties":{"structure":{"$ref":"#/components/schemas/Structure"},"server_time":{"type":"integer","format":"int64"}}}}}}}}}}}
```

## Récupérer un fichier lié à un formulaire

> Retourne le fichier lié au formulaire (actuellement uniquement les images des champs Logo).

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"structures"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/structures/{id}/file/{file_id}":{"get":{"summary":"Récupérer un fichier lié à un formulaire","description":"Retourne le fichier lié au formulaire (actuellement uniquement les images des champs Logo).","tags":["structures"],"operationId":"getStructureFile","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant du formulaire","schema":{"type":"integer"}},{"name":"file_id","in":"path","required":true,"description":"Identifiant du fichier (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Contenu de l'image","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}}}}}}}
```


---

# Agent Instructions: 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://www.center.daxium-air.com/api-reference/doc-api/formulaires.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.