unwatch_company
Retrait d'une société de la surveillance : l'enlève d'une liste de veille de l'utilisateur (page /lists de l'app Insourcia). Inverse de watch_company.
Utiliser cet outil quand l'utilisateur veut ARRÊTER de suivre une société ("je ne suis plus intéressé par X", "enlève X de ma veille", "nettoie ma liste").
Fonctionnement :
Sans list_name, la société est retirée de TOUTES les listes de l'utilisateur - c'est le sens naturel de "arrête de surveiller X". Avec list_name, seule cette liste est nettoyée.
Idempotent : si la société n'est dans aucune liste (ou si la liste nommée n'existe pas), l'appel renvoie removed=false sans erreur.
La liste elle-même n'est jamais supprimée, même si elle devient vide. Une alerte active sur la liste reste active pour les autres sociétés.
Le retrait fonctionne même pour une société absente de l'index (radiée, disparue) : ce qui a pu être ajouté peut toujours être enlevé.
list_watched_companies donne le nom exact des listes et les sociétés qu'elles contiennent.
Réponse : { siren, company_name (null si non renseignée), removed, removed_from: [{ list_id, list_name }], url (page /lists) }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siren | Yes | SIREN a 9 chiffres de la société à retirer de la veille | |
| list_name | No | Nom exact de la liste à nettoyer. Ex: "Surveillance", "Cibles M&A". Omis = retrait de toutes les listes de l'utilisateur. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| siren | Yes | ||
| removed | Yes | ||
| company_name | Yes | ||
| removed_from | Yes |