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

# Ajouter des pages à suivre

> Ajoutez jusqu’à 50 URL du domaine du workspace au Diagnostic du site. Chaque URL indique si elle est ajoutée, déjà suivie, invalide ou hors du domaine.

Ajoute jusqu’à 50 URL du domaine du workspace aux pages suivies. Une URL déjà suivie est signalée comme `already_monitored`. Ajouter une page ne l’audite pas : lancez un audit avec [Lancer un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/start-audit.md).

Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**urls** `string[]` *required*

Entre 1 et 50 URL absolues de 2048 caractères au maximum.

## Réponse

Renvoie `200` avec un tableau `items`, une entrée pour chaque URL soumise.

| Résultat | Signification |
| - | - |
| `added` | La page est désormais suivie ; `pageId` l’identifie |
| `already_monitored` | La page était déjà suivie |
| `invalid` | L’URL n’est pas valide |
| `outside_domain` | L’URL n’est pas sur le domaine du workspace |

`pageId` vaut `null` lorsque l’URL n’a pas été ajoutée.

## Requête et réponse synthétiques

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/site-diagnostics/pages" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: monitor-pages-001" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com/pricing","https://example.com/blog","https://other.example/page"]}'
```

```json theme={null}
{
  "items": [
    {
      "url": "https://example.com/pricing",
      "outcome": "added",
      "pageId": "99999999-0000-4000-8000-000000000000"
    },
    {
      "url": "https://example.com/blog",
      "outcome": "already_monitored",
      "pageId": "99999999-1111-4000-8000-000000000000"
    },
    {
      "url": "https://other.example/page",
      "outcome": "outside_domain",
      "pageId": null
    }
  ]
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | La liste est vide, contient plus de 50 URL, ou est mal formée |
| `404` | `RESOURCE_NOT_FOUND` | Le workspace est absent ou inaccessible |
| `409` | `CONFLICT` | La requête entre en conflit avec l’état actuel |

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie `403 API_KEY_READ_ONLY`. Sur `429`, respectez `Retry-After`. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie `503 SERVICE_UNAVAILABLE` et rien ne change.


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