set_geo_audit_content_idea_visibility

set_geo_audit_content_idea_visibility shows or hides one generated content idea in a report, by its hash. Generated ideas are frozen JSON, so visibility is how you curate them. Custom ideas are managed with add/remove instead. Works on a single GEO Audit and on a bulk campaign.

When to use

To curate which article angles a client-facing report shows, and to undo a generated_hidden removal from remove_geo_audit_content_idea. Tenant-scoped write; requires a non read-only API key.

Input

Response

Success

{ "success": true, "auditId": "clx_audit_42", "bulkAuditId": null, "hash": "9f8e7d6c", "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_content_ideas (generated[].hash).
• Hiding is reversible and idempotent: setting hidden: false restores the idea.
• For the whole section, use set_geo_audit_section_visibility with section: "contentIdeas": it can also tease it behind a CTA.

Related tools

• list_geo_audit_content_ideas: get the idea hash to toggle.
• set_geo_audit_section_visibility: hide or tease the whole content ideas section.
• set_geo_audit_recommendation_visibility: the same thing for recommendations.