> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Corriger les erreurs de déploiement « frontmatter must be a single endpoint string »

> Résolvez les échecs de déploiement causés par un frontmatter de page openapi, api ou asyncapi qui liste plusieurs endpoints ou utilise une valeur qui n’est pas une chaîne.

Chaque page d’endpoint MDX dans Mintlify documente exactement un endpoint. Les champs de frontmatter `openapi`, `api` et `asyncapi` doivent chacun être une seule chaîne. Si une page définit l’un de ces champs comme une liste, un nombre ou une autre valeur qui n’est pas une chaîne, Mintlify fait échouer le déploiement avec ce message :

```text theme={null}
Page api, openapi, or asyncapi frontmatter must be a single endpoint string. Deployment not updated
```

Mintlify ne publie aucune modification issue d’un déploiement échoué. Votre site en production continue de servir le dernier déploiement réussi jusqu’à ce que vous corrigiez la page.

L’erreur propre à la page commence par `Invalid "<field>" frontmatter at path`. Elle indique le chemin de la page et le type de valeur reçu par Mintlify, par exemple `received an array`.

<div id="common-causes">
  ## Causes courantes
</div>

* Lister plusieurs endpoints dans un seul champ, par exemple `openapi: [GET /users, POST /users]`.
* Écrire la valeur sous forme de liste YAML sur des lignes séparées commençant par `-`.
* Utiliser une valeur que YAML interprète comme un nombre ou un booléen au lieu d’une chaîne.

<div id="fix-the-frontmatter">
  ## Corriger le frontmatter
</div>

Définissez le champ avec une seule chaîne d’endpoint. Placez la valeur entre guillemets pour que YAML l’interprète toujours comme une chaîne.

```mdx Incorrect theme={null}
---
title: "Users"
openapi: [GET /users, POST /users]
---
```

```mdx Correct theme={null}
---
title: "List users"
openapi: "GET /users"
---
```

Pour documenter plusieurs endpoints, créez une page distincte pour chaque endpoint. Vous pouvez également laisser Mintlify générer une page par opération à partir de votre spécification. Consultez [Remplir automatiquement les pages d’API](/docs/fr/api-playground/openapi-setup#auto-populate-api-pages).

Pour le format complet du frontmatter `openapi`, consultez [Documenter les endpoints](/docs/fr/api-playground/openapi-setup#document-endpoints).


## Related topics

- [Configuration d’OpenAPI](/docs/fr/api-playground/openapi-setup.md)
- [Déploiements](/docs/fr/deploy/deployments.md)
- [Déployer sur un sous-chemin avec Cloudflare Workers](/docs/fr/deploy/cloudflare.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.