delete_visibility_persona
Permanently delete a buyer persona.
Permanently delete a buyer persona. This is irreversible — the persona will not be used in future scans. To keep it for reference, use update_visibility_persona with isActive: false instead.
Deprecated alias:
delete_personais still accepted butdelete_visibility_personais the canonical name.
Authentication: Required
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | integer | Yes | The agent ID the persona belongs to. |
personaId | string | Yes | The persona ID to delete. |
Behavior
Synchronous — the persona is removed the moment the call returns and won't appear in future scans. Historical scan data that referenced the persona by name is preserved. The delete is scoped to syntheticId, so a personaId from another agent (or one that doesn't exist) returns a not-found result rather than deleting anything. Anyone with access to the agent — including shared team members — can delete a persona, the same as creating or editing one.
Returns
deletedPersona with the removed persona's id and name.