set_geo_audit_section_visibility définit l'affichage d'une section d'un rapport GEO Audit white-label : visible (affichée en entier), teased (floutée derrière un CTA), ou hidden (retirée). Reproduit la curation qu'un owner fait à la main avant de partager un audit avec un prospect.

Quand l'utiliser

Au moment de préparer un GEO Audit pour le partage : masquez les sections que vous ne voulez pas montrer, teasez celles à mettre derrière un call-to-action, et laissez le reste visible. Teaser une section pousse à la conversion tout en montrant qu'il y a plus derrière.

Input

Champ	Type	Description
`auditId`	string (CUID)	Un GEO Audit simple, ou une cible de campagne (qui résout vers sa campagne). Exactement un de `auditId` / `bulkAuditId`.
`bulkAuditId`	string (CUID)	Une campagne, renvoyée par `list_bulk_audits`. Exactement un de `auditId` / `bulkAuditId`.
`section`	enum	Une parmi `competitorRanking`, `personas`, `competitorMatrix`, `promptCoverage`, `recommendations`, `contentIdeas`, `topSources`.
`visibility`	enum	`visible`, `teased`, ou `hidden`.
`ctaId`	string (CUID), optionnel	Le CTA affiché sur les sections teasées. Requis (ici ou déjà défini sur l'audit) quand `visibility` vaut `teased`. Passez `null` pour l'effacer ; omettez pour garder l'actuel.

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. Exige une clé API non read-only.

Response

Succès

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

teaserSections et hiddenSections sont les ensembles complets après le changement.

Erreurs

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

Récupérez un id de CTA d'abord avec list_audit_ctas avant de teaser.
Un CTA par audit. Définir ctaId en teasant change le CTA pour toutes les sections teasées de cet audit.
Une section est dans un seul état. Passer en visible la retire des ensembles teasé et masqué.

Tools liés

list_audit_ctas : récupérer un id de CTA pour teaser.
set_geo_audit_recommendation_visibility : masquer des recommandations individuelles (plus fin qu'une section entière).
get_geo_audit : lire l'audit.