Mentionable
Mentionable

remove_geo_audit_recommendation

Tool MCP remove_geo_audit_recommendation : retirer une recommandation custom d'un GEO Audit par son id.

Mis à jour le 2026-07-23

remove_geo_audit_recommendation retire une recommandation custom d'un GEO Audit par son id. Seules les recommandations custom (ajoutées via add_geo_audit_recommendation ou à la main) peuvent être retirées ; les recommandations générées par l'IA sont figées et peuvent seulement être masquées. Tenant-scoped (écriture), single audits uniquement.

Quand l'utiliser

Pour annuler une recommandation custom ajoutée par un agent ou un owner. Récupérez l'id via list_geo_audit_recommendations (le champ custom[].id).

Input

Champ Type Description
auditId string (CUID) L'id du GEO Audit.
customRecoId string L'id de la recommandation custom à retirer.

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId. Exige une clé API non read-only.

Response

Succès

{ "success": true, "auditId": "clx_audit_42", "removed": true }

removed vaut false quand aucune reco custom ne correspond à cet id (déjà retirée, ou l'id appartient à une reco générée). L'appel réussit quand même : il est idempotent.

Erreurs

{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. ..." }
{ "success": false, "error": "bulk_unsupported", "message": "This audit is part of a bulk campaign; its recommendations are managed at the campaign level, not via this tool." }

Tips et patterns

  • Utilisez le custom[].id de list_geo_audit_recommendations. Les recos générées exposent un hash, pas un id, et ne sont pas retirables ici.
  • Idempotent : retirer un id déjà retiré renvoie removed: false plutôt qu'une erreur.

Tools liés