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

# Authentification

> Comment s'authentifier auprès de l'API Orova

## Authentification par clé API

Toutes les requêtes API sont authentifiées à l'aide d'une clé API. Générez-en une depuis le [tableau de bord Orova](https://app.orova.ai) et incluez-la dans l'en-tête `x-api-key` :

```bash theme={null}
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"
```

### Créer une clé API

<Steps>
  <Step title="Connectez-vous au tableau de bord">
    Rendez-vous sur [app.orova.ai](https://app.orova.ai) et connectez-vous.
  </Step>

  <Step title="Accédez à Clés API">
    Allez dans **Settings → API Keys**.
  </Step>

  <Step title="Créer une clé">
    Cliquez sur **Create API Key** et donnez-lui un nom descriptif.
  </Step>

  <Step title="Copier la clé">
    Copiez la clé immédiatement — elle ne s'affiche qu'une seule fois.
  </Step>
</Steps>

<Warning>
  Gardez votre clé API secrète. Ne l'exposez pas dans le code côté client (sauf pour l'attribut `data-api-key` du widget). Utilisez-la uniquement dans les requêtes serveur à serveur.
</Warning>

## Utilisation de la clé API

Incluez-la dans chaque requête en tant qu'en-tête :

```bash theme={null}
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"
```

Ou dans le widget intégrable :

```html theme={null}
<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  ...
></script>
```

## Isolation des espaces de travail

Toutes les données sont limitées à un espace de travail. Incluez `workspaceId` en tant que paramètre de requête ou dans le corps de la requête lorsque nécessaire :

```bash theme={null}
curl "https://app.orova.ai/api/agents?workspaceId=WORKSPACE_ID" \
  -H "x-api-key: YOUR_API_KEY"
```