set_geo_audit_recommendation_visibility

set_geo_audit_recommendation_visibility affiche ou masque une recommandation générée d'un rapport GEO Audit white-label, identifiée par son hash. À utiliser pour une curation plus fine que masquer une section entière : garder la section recommandations visible mais retirer le ou les items que vous ne voulez pas montrer au prospect.

Quand l'utiliser

Après avoir listé les recommandations avec list_geo_audit_recommendations, masquez une recommandation générée précise par son hash, ou réaffichez-en une masquée. Les recommandations custom ne se gèrent pas ici ; ajoutez/retirez-les avec add_geo_audit_recommendation / remove_geo_audit_recommendation.

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, "hash": "1a2b3c4d", "hidden": true }

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

• Utilisez le hash, pas un titre. Récupérez-le via list_geo_audit_recommendations (generated[].hash).
• Le masquage est réversible et idempotent : hidden: false réaffiche la recommandation.
• Pour des sections entières, utilisez plutôt set_geo_audit_section_visibility.
• C'est l'annulation d'un retrait generated_hidden fait par remove_geo_audit_recommendation.

Tools liés

• list_geo_audit_recommendations : récupérer le hash de la recommandation à basculer.
• set_geo_audit_section_visibility : masquer ou teaser la section recommandations entière.