set_geo_audit_section_visibility sets how one section of a white-label GEO Audit report appears: visible (shown in full), teased (blurred behind a CTA), or hidden (removed). It mirrors the curation an owner does by hand before sharing an audit with a prospect.

When to use

When preparing a GEO Audit for sharing: hide sections you don't want the prospect to see, tease the ones you want to gate behind a call-to-action, and leave the rest visible. Tease a section to drive conversions while showing there is more behind it.

Input

Field	Type	Description
`auditId`	string (CUID)	A single GEO Audit, or a bulk campaign target (which resolves to its campaign). Exactly one of `auditId` / `bulkAuditId`.
`bulkAuditId`	string (CUID)	A bulk campaign, from `list_bulk_audits`. Exactly one of `auditId` / `bulkAuditId`.
`section`	enum	One of `competitorRanking`, `personas`, `competitorMatrix`, `promptCoverage`, `recommendations`, `contentIdeas`, `topSources`.
`visibility`	enum	`visible`, `teased`, or `hidden`.
`ctaId`	string (CUID), optional	The CTA shown on teased sections. Required (here or already set on the audit) when `visibility` is `teased`. Pass `null` to clear it; omit to keep the current one.

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. Requires a non read-only API key.

Response

Success

{
  "success": true,
  "auditId": "clx_audit_42",
  "section": "recommendations",
  "visibility": "teased",
  "teaserSections": ["recommendations"],
  "hiddenSections": ["topSources"],
  "ctaId": "clx_cta_1"
}

teaserSections and hiddenSections are the full resulting sets after the change.

Errors

{ "success": false, "error": "cta_required", "message": "Teasing a section requires a CTA. Pass ctaId (see list_audit_ctas) or set one first." }
{ "success": false, "error": "cta_not_found", "message": "No CTA with this id exists in your workspace. Use list_audit_ctas to get a valid id." }
{ "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. ..." }
{ "success": false, "error": "target_required", "message": "Pass exactly one of auditId (a GEO audit) or bulkAuditId (a bulk campaign)." }

Tips and patterns

Get a CTA id first with list_audit_ctas before teasing.
One CTA per audit. Setting ctaId while teasing changes the CTA for all teased sections of that audit.
A section is in exactly one state. Switching to visible removes it from both the teased and hidden sets.

Related tools

list_audit_ctas: get a CTA id to tease with.
set_geo_audit_recommendation_visibility: hide individual recommendations (finer-grained than a whole section).
get_geo_audit: read the audit.