delete-ava-conversation
dci delete-ava-conversation [flags]
Deletes an Ava conversation by its ID.
Confirmation required
Interactive terminals show a confirmation prompt; scripts must pass --yes — see the CLI
guide's Destructive commands.
The ID is a flag
The conversation is identified by --conversation-id, not a positional argument. Get the ID
from the conversationId a persisted (ephemeral: false) dci ask-ava-sync call returns.
Examples
# Preview the deletion locally without sending anything.
dci delete-ava-conversation --conversation-id <conversation-id> --dry-run
# Delete without a prompt, for scripts.
dci delete-ava-conversation --conversation-id <conversation-id> --yes
Exit code 0 and no output.
Flags
| Flag | Type | Default | Example | Description |
|---|---|---|---|---|
--conversation-id | string | The ID of the conversation to delete. |
Every command also accepts the CLI-wide flags for output shaping — see Output formats and Table output options.
Output
On success, this command produces no response data.
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
HTTP status to exit code mapping
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 500 | 40 | API_SERVER_ERROR | The API failed to process the request. Retryable; contact DoiT support if it persists. |
Related
- ask-ava-sync — Ask Ava
- ask-ava-streaming — Ask Ava (streaming)
- submit-ava-feedback — Submit feedback
- API reference: DELETE /ava/v1/deleteConversation
Aliases: deleteavaconversation