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

# Recherche

## Recherche rapide de documents

> Toute recherche de moins de 3 caractères ne remontera aucun résultat

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Document"},{"name":"Recherche"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"GabaritDeDocumentId":{"type":"string","format":"uuid"},"BannetteId":{"type":"string","format":"uuid"},"DossierId":{"type":"string","format":"uuid"},"ArmoireId":{"type":"string","format":"uuid"},"ResultatRecherche":{"type":"object","required":["id","nom","mediaType","metadonnees"],"properties":{"id":{"$ref":"#/components/schemas/DocumentId"},"nom":{"type":"string"},"mediaType":{"type":"string"},"gabarit":{"description":"Peut ne pas être présent dans le cas où le document n'est pas encore classé","type":"object","required":["id","nom"],"properties":{"id":{"$ref":"#/components/schemas/GabaritDeDocumentId"},"nom":{"type":"string"}}},"armoire":{"description":"Peut ne pas être présent dans le cas où le document n'est pas encore classé","type":"object","required":["id","nom"],"properties":{"id":{"$ref":"#/components/schemas/ArmoireId"},"nom":{"type":"string"}}},"bannette":{"description":"Peut ne pas être présent dans le cas où le document est déjà classé","type":"object","required":["id","nom"],"properties":{"id":{"$ref":"#/components/schemas/BannetteId"},"nom":{"type":"string"}}},"dossier":{"description":"Peut ne pas être présent dans le cas où le document n'est pas classé dans un dossier (ou encore dans une bannette)","type":"object","required":["id","nom","gabarit"],"properties":{"id":{"$ref":"#/components/schemas/DossierId"},"nom":{"type":"string"},"gabarit":{"type":"object","required":["id","nom"],"properties":{"id":{"$ref":"#/components/schemas/GabaritDeDossierId"},"nom":{"type":"string"}}}}},"metadonnees":{"type":"array","items":{"type":"object","required":["structure","libelle","format","valeur"],"properties":{"structure":{"$ref":"#/components/schemas/StructureMetadonneeId"},"libelle":{"type":"string"},"format":{"$ref":"#/components/schemas/MetadonneeFormat"},"valeur":{"$ref":"#/components/schemas/ValeurMetadonnee"}}}}}},"DocumentId":{"type":"string","format":"uuid"},"GabaritDeDossierId":{"type":"string","format":"uuid"},"StructureMetadonneeId":{"type":"string","format":"uuid"},"MetadonneeFormat":{"type":"string","enum":["texte","paragraphe","numerique","date","bool","enum"]},"ValeurMetadonnee":{"oneOf":[{"type":"string","description":"La valeur peut être n'importe quelle `string` pour les format `texte` et `paragraphe`. Le format `date` peut être une `string` respectant le schéma `Y-m-d`."},{"type":"number","description":"La valeur peut être soit un `int` soit un `float`"},{"type":"boolean"},{"type":"array","items":{"type":"object","required":["id","valeur"],"properties":{"id":{"$ref":"#/components/schemas/ValeurMetadonneeId"},"valeur":{"type":"string"}}},"description":"Ce type de donnée n'est à utiliser qu'avec le format `enum`"}],"nullable":true},"ValeurMetadonneeId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/recherche/rapide/documents":{"post":{"operationId":"rechercheRapideDocuments","summary":"Recherche rapide de documents","description":"Toute recherche de moins de 3 caractères ne remontera aucun résultat","tags":["Recherche","Document"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"title":"Recherche globale","type":"object","required":["recherche"],"properties":{"recherche":{"type":"string"}},"additionalProperties":false},{"title":"Recherche dans une liste de gabarits","type":"object","required":["recherche","gabarits"],"properties":{"recherche":{"type":"string"},"gabarits":{"type":"array","items":{"$ref":"#/components/schemas/GabaritDeDocumentId"},"description":"Liste d'ids de gabarits de documents"}}},{"title":"Recherche dans une liste de bannettes","type":"object","required":["recherche","bannettes"],"properties":{"recherche":{"type":"string"},"bannettes":{"type":"array","items":{"$ref":"#/components/schemas/BannetteId"},"description":"Liste d'ids de bannettes"}}},{"title":"Recherche sur un dossier","type":"object","required":["recherche","dossier"],"properties":{"recherche":{"type":"string"},"dossier":{"$ref":"#/components/schemas/DossierId"}}},{"title":"Recherche sur une armoire","type":"object","required":["recherche","armoire"],"properties":{"recherche":{"type":"string"},"armoire":{"$ref":"#/components/schemas/ArmoireId"}}}]}}}},"responses":{"200":{"description":"Liste des documents contenant l'ensemble des termes recherchés","content":{"application/json":{"schema":{"type":"object","required":["count","documents"],"properties":{"count":{"type":"integer","description":"L'ensemble des documents qui correspondent, tous ne sont pas forcément remontés dans la réponse"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/ResultatRecherche"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## POST /api/recherche/documents

> Recherche de documents

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Document"},{"name":"Recherche"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"GabaritDeDocumentId":{"type":"string","format":"uuid"},"StructureMetadonneeId":{"type":"string","format":"uuid"},"ValeurRechercheMetadonnee":{"oneOf":[{"type":"string","description":"La valeur peut être n'importe quelle `string` pour les format `texte` et `paragraphe`. Le format `date` peut être une `string` respectant le schéma `Y-m-d`. Le format enum est un uuid"},{"type":"number","description":"La valeur peut être soit un `int` soit un `float`. Il est possible de rechercher des `float` jusqu'à 4 chiffres après la virgule."},{"type":"boolean"}]},"ValeurRechercheDonneeSysteme":{"type":"string","format":"date"},"Document":{"type":"object","required":["id","nom","mediaType","classe","preClasse","creeLe","misAJourLe","metadonnees","indexationDemandeeLe","indexeLe","empreinte","verrouille","versions","creePar"],"properties":{"id":{"$ref":"#/components/schemas/DocumentId"},"nom":{"type":"string"},"mediaType":{"type":"string","description":"Media type de la version la plus récente"},"classe":{"type":"boolean"},"preClasse":{"type":"boolean"},"gabarit":{"$ref":"#/components/schemas/GabaritDeDocumentId"},"dossier":{"$ref":"#/components/schemas/DossierId"},"bannette":{"$ref":"#/components/schemas/BannetteId"},"creeLe":{"type":"string","format":"date-time"},"misAJourLe":{"type":"string","format":"date-time"},"metadonnees":{"type":"array","items":{"$ref":"#/components/schemas/Metadonnee"}},"indexationDemandeeLe":{"type":"string","format":"date-time","nullable":true},"indexeLe":{"type":"string","format":"date-time","nullable":true},"empreinte":{"type":"string","description":"Empreinte de la version la plus récente"},"verrouille":{"type":"boolean"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/Version"}},"creePar":{"type":"object","required":["nomComplet"],"properties":{"nomComplet":{"type":"string"}},"nullable":true},"objetNumeriqueCCFN":{"type":"object","required":["objetNumerique","conteneur","empreinte","algorithmeEmpreinte","creeLe"],"properties":{"objetNumerique":{"type":"string","format":"uuid"},"conteneur":{"$ref":"#/components/schemas/ConteneurId"},"empreinte":{"type":"string"},"algorithmeEmpreinte":{"type":"string"},"creeLe":{"type":"string","format":"date-time"}}},"suppressionPrevueLe":{"type":"string","format":"date-time"}}},"DocumentId":{"type":"string","format":"uuid"},"DossierId":{"type":"string","format":"uuid"},"BannetteId":{"type":"string","format":"uuid"},"Metadonnee":{"type":"object","required":["structure","valeur"],"properties":{"structure":{"$ref":"#/components/schemas/StructureMetadonneeId"},"valeur":{"$ref":"#/components/schemas/ValeurMetadonnee"}}},"ValeurMetadonnee":{"oneOf":[{"type":"string","description":"La valeur peut être n'importe quelle `string` pour les format `texte` et `paragraphe`. Le format `date` peut être une `string` respectant le schéma `Y-m-d`."},{"type":"number","description":"La valeur peut être soit un `int` soit un `float`"},{"type":"boolean"},{"type":"array","items":{"type":"object","required":["id","valeur"],"properties":{"id":{"$ref":"#/components/schemas/ValeurMetadonneeId"},"valeur":{"type":"string"}}},"description":"Ce type de donnée n'est à utiliser qu'avec le format `enum`"}],"nullable":true},"ValeurMetadonneeId":{"type":"string","format":"uuid"},"Version":{"type":"object","required":["id","mediaType","empreinte","creeLe","nom"],"properties":{"id":{"$ref":"#/components/schemas/VersionId"},"mediaType":{"type":"string"},"empreinte":{"type":"string"},"creeLe":{"type":"string","format":"date-time"},"nom":{"type":"string"}}},"VersionId":{"type":"integer"},"ConteneurId":{"type":"string","format":"uuid"},"Dossier":{"type":"object","required":["id","nom","gabarit","metadonnees","indexationDemandeeLe","indexeLe","creeLe","creePar","misAJourLe","filtresAcces","archiverLeContenu"],"properties":{"id":{"$ref":"#/components/schemas/DossierId"},"nom":{"type":"string"},"gabarit":{"$ref":"#/components/schemas/GabaritDeDossierId"},"metadonnees":{"type":"array","items":{"$ref":"#/components/schemas/Metadonnee"}},"indexationDemandeeLe":{"type":"string","format":"date-time","nullable":true},"indexeLe":{"type":"string","format":"date-time","nullable":true},"creeLe":{"type":"string","format":"date-time"},"creePar":{"type":"object","required":["nomComplet"],"properties":{"nomComplet":{"type":"string"}},"nullable":true},"misAJourLe":{"type":"string","format":"date-time","nullable":true},"filtresAcces":{"type":"array","items":{"oneOf":[{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},{"type":"object","required":["filtre","utilisateur"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"utilisateur":{"$ref":"#/components/schemas/UtilisateurId"}}}]}},"archiverLeContenu":{"type":"boolean"}}},"GabaritDeDossierId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"},"UtilisateurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/recherche/documents":{"post":{"operationId":"rechercheDocuments","summary":"Recherche de documents","tags":["Recherche","Document"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gabarit","conditions"],"properties":{"gabarit":{"$ref":"#/components/schemas/GabaritDeDocumentId"},"conditions":{"type":"array","items":{"anyOf":[{"type":"object","required":["operateur","metadonnee","condition","valeur"],"properties":{"operateur":{"type":"string","enum":["et","ou"]},"metadonnee":{"$ref":"#/components/schemas/StructureMetadonneeId"},"condition":{"type":"string","enum":["contient","egal","superieur","inferieur"]},"valeur":{"$ref":"#/components/schemas/ValeurRechercheMetadonnee"}}},{"type":"object","required":["operateur","systeme","condition","valeur"],"properties":{"operateur":{"type":"string","enum":["et","ou"]},"systeme":{"type":"string","enum":["creeLe","misAJourLe","classeLe"]},"condition":{"type":"string","enum":["egal","superieur","inferieur"]},"valeur":{"$ref":"#/components/schemas/ValeurRechercheDonneeSysteme"}}}]}}}}}}},"responses":{"200":{"description":"Liste des documents correspondants à la recherche","content":{"application/json":{"schema":{"type":"object","required":["documents","dossiers"],"properties":{"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"}},"dossiers":{"type":"array","items":{"$ref":"#/components/schemas/Dossier"},"description":"Il s'agit des dossiers dans lesquels se trouvent les documents remontés par la recherche. Si les documents ne sont pas dans des dossiers alors cette liste est vide."}}}}}},"400":{"description":"Le format ou la condition de recherche sur une métadonnée de type enum ou une donnée système est invalide","content":{"application/json":{"schema":{"title":"Le format ou la condition de recherche sur une métadonnée de type enum ou une donnée système est invalide","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["condition_recherche_metadonnee_enum_invalide"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"Le gabarit n'existe pas","content":{"application/json":{"schema":{"title":"Gabarit inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["gabarit_de_document_inexistant","metadonnee_inexistante"]}}}}}},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## Recherche rapide de dossiers

> Toute recherche de moins de 3 caractères ne remontera aucun résultat

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Dossier"},{"name":"Recherche"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"GabaritDeDossierId":{"type":"string","format":"uuid"},"ArmoireId":{"type":"string","format":"uuid"},"ResultatRechercheDossier":{"type":"object","required":["id","nom","gabarit","armoire","metadonnees"],"properties":{"id":{"$ref":"#/components/schemas/DossierId"},"nom":{"type":"string"},"gabarit":{"type":"object","required":["id","nom"],"properties":{"id":{"$ref":"#/components/schemas/GabaritDeDossierId"},"nom":{"type":"string"}}},"armoire":{"type":"object","required":["id","nom"],"properties":{"id":{"$ref":"#/components/schemas/ArmoireId"},"nom":{"type":"string"}}},"metadonnees":{"type":"array","items":{"type":"object","required":["structure","libelle","format","valeur"],"properties":{"structure":{"$ref":"#/components/schemas/StructureMetadonneeId"},"libelle":{"type":"string"},"format":{"$ref":"#/components/schemas/MetadonneeFormat"},"valeur":{"$ref":"#/components/schemas/ValeurMetadonnee"}}}},"suppressionPrevueLe":{"type":"string","format":"date-time"}}},"DossierId":{"type":"string","format":"uuid"},"StructureMetadonneeId":{"type":"string","format":"uuid"},"MetadonneeFormat":{"type":"string","enum":["texte","paragraphe","numerique","date","bool","enum"]},"ValeurMetadonnee":{"oneOf":[{"type":"string","description":"La valeur peut être n'importe quelle `string` pour les format `texte` et `paragraphe`. Le format `date` peut être une `string` respectant le schéma `Y-m-d`."},{"type":"number","description":"La valeur peut être soit un `int` soit un `float`"},{"type":"boolean"},{"type":"array","items":{"type":"object","required":["id","valeur"],"properties":{"id":{"$ref":"#/components/schemas/ValeurMetadonneeId"},"valeur":{"type":"string"}}},"description":"Ce type de donnée n'est à utiliser qu'avec le format `enum`"}],"nullable":true},"ValeurMetadonneeId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/recherche/rapide/dossiers":{"post":{"operationId":"rechercheRapideDossiers","summary":"Recherche rapide de dossiers","description":"Toute recherche de moins de 3 caractères ne remontera aucun résultat","tags":["Recherche","Dossier"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"title":"Recherche globale","type":"object","required":["recherche"],"properties":{"recherche":{"type":"string"}},"additionalProperties":false},{"title":"Recherche dans une liste de gabarits","type":"object","required":["recherche","gabarits"],"properties":{"recherche":{"type":"string"},"gabarits":{"type":"array","items":{"$ref":"#/components/schemas/GabaritDeDossierId"},"description":"Liste d'ids de gabarits de dossiers"}}},{"title":"Recherche sur une armoire","type":"object","required":["recherche","armoire"],"properties":{"recherche":{"type":"string"},"armoire":{"$ref":"#/components/schemas/ArmoireId"}}}]}}}},"responses":{"200":{"description":"Liste des dossiers contenant l'ensemble des termes recherchés","content":{"application/json":{"schema":{"type":"object","required":["count","dossiers"],"properties":{"count":{"type":"integer","description":"L'ensemble des dossiers qui correspondent, tous ne sont pas forcément remontés dans la réponse"},"dossiers":{"type":"array","items":{"$ref":"#/components/schemas/ResultatRechercheDossier"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## POST /api/recherche/dossiers

> Recherche de dossiers

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Dossier"},{"name":"Recherche"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]},{"ApiKey":[],"Impersonification":[]},{"ApiKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"},"ApiKey":{"type":"apiKey","name":"x-api-key","in":"header","description":"Clé d'API définie dans le manifeste de Doc dans la partie `Efalia Process > Clé API`."}},"schemas":{"GabaritDeDossierId":{"type":"string","format":"uuid"},"StructureMetadonneeId":{"type":"string","format":"uuid"},"ValeurRechercheMetadonnee":{"oneOf":[{"type":"string","description":"La valeur peut être n'importe quelle `string` pour les format `texte` et `paragraphe`. Le format `date` peut être une `string` respectant le schéma `Y-m-d`. Le format enum est un uuid"},{"type":"number","description":"La valeur peut être soit un `int` soit un `float`. Il est possible de rechercher des `float` jusqu'à 4 chiffres après la virgule."},{"type":"boolean"}]},"Dossier":{"type":"object","required":["id","nom","gabarit","metadonnees","indexationDemandeeLe","indexeLe","creeLe","creePar","misAJourLe","filtresAcces","archiverLeContenu"],"properties":{"id":{"$ref":"#/components/schemas/DossierId"},"nom":{"type":"string"},"gabarit":{"$ref":"#/components/schemas/GabaritDeDossierId"},"metadonnees":{"type":"array","items":{"$ref":"#/components/schemas/Metadonnee"}},"indexationDemandeeLe":{"type":"string","format":"date-time","nullable":true},"indexeLe":{"type":"string","format":"date-time","nullable":true},"creeLe":{"type":"string","format":"date-time"},"creePar":{"type":"object","required":["nomComplet"],"properties":{"nomComplet":{"type":"string"}},"nullable":true},"misAJourLe":{"type":"string","format":"date-time","nullable":true},"filtresAcces":{"type":"array","items":{"oneOf":[{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},{"type":"object","required":["filtre","utilisateur"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"utilisateur":{"$ref":"#/components/schemas/UtilisateurId"}}}]}},"archiverLeContenu":{"type":"boolean"}}},"DossierId":{"type":"string","format":"uuid"},"Metadonnee":{"type":"object","required":["structure","valeur"],"properties":{"structure":{"$ref":"#/components/schemas/StructureMetadonneeId"},"valeur":{"$ref":"#/components/schemas/ValeurMetadonnee"}}},"ValeurMetadonnee":{"oneOf":[{"type":"string","description":"La valeur peut être n'importe quelle `string` pour les format `texte` et `paragraphe`. Le format `date` peut être une `string` respectant le schéma `Y-m-d`."},{"type":"number","description":"La valeur peut être soit un `int` soit un `float`"},{"type":"boolean"},{"type":"array","items":{"type":"object","required":["id","valeur"],"properties":{"id":{"$ref":"#/components/schemas/ValeurMetadonneeId"},"valeur":{"type":"string"}}},"description":"Ce type de donnée n'est à utiliser qu'avec le format `enum`"}],"nullable":true},"ValeurMetadonneeId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"},"UtilisateurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/recherche/dossiers":{"post":{"operationId":"rechercheDossiers","summary":"Recherche de dossiers","tags":["Recherche","Dossier"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gabarit","conditions"],"properties":{"gabarit":{"$ref":"#/components/schemas/GabaritDeDossierId"},"conditions":{"type":"array","items":{"type":"object","required":["operateur","metadonnee","condition","valeur"],"properties":{"operateur":{"type":"string","enum":["et","ou"]},"metadonnee":{"$ref":"#/components/schemas/StructureMetadonneeId"},"condition":{"type":"string","enum":["contient","egal","superieur","inferieur"]},"valeur":{"$ref":"#/components/schemas/ValeurRechercheMetadonnee"}}}}}}}}},"responses":{"200":{"description":"Liste des dossiers correspondants à la recherche","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Dossier"}}}}},"400":{"description":"Condition de recherche sur métadonnée de type enum invalide ou format de valeur sur métadonnée numérique invalide","content":{"application/json":{"schema":{"title":"Condition de recherche sur métadonnée de type enum invalide ou format de valeur sur métadonnée numérique invalide","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["condition_recherche_metadonnee_enum_invalide","format_valeur_recherche_metadonnee_numerique_invalide"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"Le gabarit n'existe pas","content":{"application/json":{"schema":{"title":"Gabarit dossier","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["gabarit_de_dossier_inexistant","metadonnee_inexistante"]}}}}}},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```


---

# 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, and the optional `goal` query parameter:

```
GET https://documentation.efalia.com/api-reference/efalia-doc-api/recherche.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.