remove_geo_audit_recommendation

remove_geo_audit_recommendation retire une recommandation d'un rapport. Une reco custom (ajoutée via add_geo_audit_recommendation ou à la main) est supprimée. Une reco générée est du JSON figé : elle est retirée du rapport en étant masquée, exactement ce que fait le toggle de l'app, et c'est réversible. Fonctionne sur un GEO Audit simple et sur une campagne en masse. Tenant-scoped (écriture).

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

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId. Ciblez un rapport avec auditId ou bulkAuditId, jamais les deux. Sur une campagne, la modification s'applique au template de réglages partagé que rend chaque rapport de cible : un seul appel couvre tout le lot. Passer l'auditId d'une cible résout vers sa campagne pour la même raison : une cible n'a pas de réglages propres. La réponse renvoie toujours la cible résolue en auditId / bulkAuditId (l'un des deux à null). Exige une clé API non read-only.

Response

Succès

{ "success": true, "auditId": "clx_audit_42", "bulkAuditId": null, "removed": "custom_deleted" }

removed dit ce qui s'est réellement passé : custom_deleted (un item custom supprimé) ou generated_hidden (un item généré masqué). Une référence qui ne correspond ni à un id custom ni à un hash généré renvoie item_not_found plutôt qu'un no-op silencieux.

Erreurs

{ "success": false, "error": "target_required", "message": "Pass exactly one of auditId (a GEO audit) or bulkAuditId (a bulk campaign)." }
{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. ..." }
{ "success": false, "error": "bulk_audit_not_found", "message": "No bulk campaign with this id exists in your workspace. ..." }

Tips et patterns

• Listez d'abord. list_geo_audit_recommendations donne les deux poignées : custom[].id et generated[].hash.
• Le masquage est réversible. set_geo_audit_recommendation_visibility avec hidden: false remet une reco générée. Une reco custom supprimée est perdue : il faut la ré-ajouter.
• Lisez removed au lieu de supposer : il dit si vous avez supprimé un item custom ou masqué un item généré.

Tools liés

• list_geo_audit_recommendations : trouver l'id de la reco custom.
• add_geo_audit_recommendation : ajouter une reco custom.