set_geo_audit_recommendation_visibility

set_geo_audit_recommendation_visibility shows or hides a single generated recommendation in a white-label GEO Audit report, identified by its hash. Use it for finer-grained curation than hiding a whole section: keep the recommendations section visible but drop the one or two items you don't want the prospect to see.

When to use

After listing recommendations with list_geo_audit_recommendations, hide a specific generated recommendation by its hash, or restore a hidden one. Custom recommendations are not toggled here; add or remove them with add_geo_audit_recommendation / remove_geo_audit_recommendation.

Input

GEO Audits are workspace-scoped, so this tool takes no projectId. Address a report with auditId or bulkAuditId, never both. On a bulk campaign the change applies to the shared settings template every target report renders, so one call covers the whole batch. Passing a campaign target's auditId resolves to its campaign for the same reason: a target has no settings of its own. The response always echoes the resolved target as auditId / bulkAuditId (one of them null).

Response

Success

{ "success": true, "auditId": "clx_audit_42", "bulkAuditId": null, "hash": "1a2b3c4d", "hidden": true }

Errors

{ "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 and patterns

• Use the hash, not a title. Get it from list_geo_audit_recommendations (generated[].hash).
• Hiding is reversible and idempotent: setting hidden: false restores the recommendation.
• For whole sections, use set_geo_audit_section_visibility instead.
• This is the undo of a generated_hidden removal from remove_geo_audit_recommendation.

Related tools

• list_geo_audit_recommendations: get the recommendation hash to toggle.
• set_geo_audit_section_visibility: hide or tease the whole recommendations section.