add_geo_audit_content_idea adds a custom content idea to a report, exactly like an owner can do by hand in the audit UI. An agent that found a gap in the LLM answers can turn it into an article angle the report carries. On a bulk campaign the idea lands on the shared template, so every target report gets it.

When to use

After reading the report's fan-outs, sources and existing ideas, add the angles your workflow produced. The new idea appears in the report's content ideas section alongside the AI-generated ones. Tenant-scoped write; requires a non read-only API key.

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`.
`title`	string	1–200 chars. The article.
`angle`	string	1–1200 chars. What it argues and who it is for.

Response

Success

{
  "success": true,
  "auditId": null,
  "bulkAuditId": "clx_bulk_42",
  "idea": {
    "id": "idea_ab12cd34",
    "title": "How to choose a plumber in Lyon",
    "angle": "Buyer guide answering the comparison prompts the LLMs get asked"
  }
}

The returned idea.id is the handle to delete it later with remove_geo_audit_content_idea.

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

List first with list_geo_audit_content_ideas to avoid two ideas that are the same article.
Put the reader in the angle. The title is the article; the angle says what it argues and who it is for, which is what makes it actionable.
There is no update call. To reword a custom idea, remove it and add it again.
On a campaign, one add serves N reports. Use bulkAuditId (or any target's auditId) when the angle applies to the whole segment.

Related tools

list_geo_audit_content_ideas: read the current ideas first.
remove_geo_audit_content_idea: delete a custom idea.
add_geo_audit_recommendation: the same thing for the report's recommendations.