Faurya CLI

Destructive Commands

Understand Faurya CLI delete, remove, rotate, revoke, and overwrite operations, confirmations, and safe scripting.

Destructive Commands

Destructive commands can delete, remove, revoke, rotate, or overwrite important website resources. Review the target website and resource ID before running them.

Commands that require destructive confirmation

CommandEffect
faurya funnels delete <websiteId> <funnelId>Deletes a saved funnel.
faurya website domain remove <websiteId>Removes an additional domain.
faurya website exclusions remove <websiteId>Removes a tracking exclusion.
faurya teams remove <websiteId> <memberId>Removes a member’s website access.
faurya alerts delete <websiteId> <alertId>Deletes an alert.
faurya tokens rotate <websiteId> <tokenId>Revokes a site API key and creates a replacement.
faurya tokens revoke <websiteId> <tokenId>Revokes a site API key.

Interactive confirmation

In an interactive terminal, the CLI prompts before destructive commands. Type yes when you are certain.

faurya funnels delete <websiteId> <funnelId>

Non-interactive scripts

In non-interactive contexts, destructive commands refuse to run without --yes.

faurya alerts delete <websiteId> <alertId> --yes
faurya tokens revoke <websiteId> <tokenId> --yes

Review before confirming

Before adding --yes, verify:

  • The active account is correct.
  • The <websiteId> is the intended website.
  • The resource ID is copied from a fresh list or get command.
  • The action is needed, not just a read-only inspection.
  • Any replacement secret from a rotation can be stored immediately.

Rotation and revocation implications

Rotating a site API key disables the old key and creates a replacement secret. Applications using the old key must be updated.

Revoking a site API key disables it without creating a replacement.

faurya tokens rotate <websiteId> <tokenId> --yes
faurya tokens revoke <websiteId> <tokenId> --yes

Overwrite-style writes

Some commands are not marked destructive by the CLI but still overwrite configuration:

CommandReview
faurya website update <websiteId>Timezone and currency settings.
faurya website kpi set <websiteId>Primary KPI.
faurya website name set <websiteId>Display name.
faurya website domain set <websiteId>Primary domain.
faurya website dashboard layout <websiteId>Dashboard order.
faurya website dashboard ai-crawl-card <websiteId>AI crawl card visibility.
faurya website widgets enable <websiteId>Widget availability.
faurya website reports enable <websiteId>Weekly report setting.
faurya alerts update <websiteId> <alertId>Alert recipient, goals, templates, or enabled state.
faurya funnels update <websiteId> <funnelId>Saved funnel name or steps.

Use these carefully in scripts even though they do not require destructive confirmation.

Deleted, revoked, or rotated resources may not be recoverable through the CLI. Prefer listing and reading the resource before changing it.