Ad Account Audit and Keywords

Role and auth requirements

• Primary roles: OWNER, OPERATOR
• Auth mode: JWT (Authorization: Bearer <token>)

UI flow (draft)

1. Open ad account audit view.
2. Run audit and keyword analysis.
3. Apply recommendations to campaigns.

API fallback (draft)

• POST /v2/handles/{handle}/ad-intelligence/audit
• POST /v2/handles/{handle}/ad-intelligence/keywords

Failure and remediation (draft)

• 400 invalid_payload: verify analysis inputs.
• 401 unauthorized: re-authenticate and retry.
• 404 not_found: confirm handle/account linkage exists.
• 503 unavailable: retry after ingestion dependencies recover.