# Activer ou désactiver

> Met le réceptionniste IA sur la ligne ou l'en retire, et renvoie la configuration complète avec le nouveau statut.

`PUT /v2/api/numbers/{number}/agent/status`

<Note>
**Scope requis :** `AGENTS_WRITE`
</Note>

## Comportement

Met le réceptionniste IA sur la ligne ou l'en retire, et renvoie la configuration complète avec le nouveau statut.

- `ACTIVE` : le réceptionniste répond aux appels entrants.
- `FORWARDING` : il ne répond pas, et les appels partent vers votre téléphone professionnel.

<Warning>
Cet appel reprogramme le routage d'une ligne en service, avec de vrais appels. Il a volontairement son propre endpoint pour qu'une écriture de configuration ne puisse jamais le déclencher par accident. Configurez entièrement le réceptionniste avant de l'activer, et faites confirmer par une personne avant d'appeler.
</Warning>

Désactiver le réceptionniste renvoie les appels vers le numéro professionnel de votre espace de travail : il faut donc qu'il y en ait un. Ce numéro n'est pas le `business_phone` du réceptionniste et ne se modifie pas par cette API.

## Erreurs

- `400 AGENT_NO_FORWARDING_NUMBER` : `FORWARDING` a été demandé alors qu'aucun numéro professionnel n'est renseigné sur l'espace de travail. Tant qu'il n'y en a pas, le réceptionniste ne peut rester qu'en `ACTIVE`.
- `409 AGENT_LINE_NOT_ASSIGNED` : aucun numéro n'est attribué à la ligne, elle ne peut donc ni répondre ni transférer.
- `404 PHONE_NUMBER_NOT_FOUND` : ce numéro n'est pas un numéro auquel vous avez accès.
