doctl signals deletion

Generated on 13 Nov 2026 from doctl version v2.5.0

Usage

doctl signals deletion [flags]

Aliases

deletions

Description

The subcommands of doctl signals deletion permanently delete Signals conversation data on demand.

Deletion cannot be undone. When you create a deletion for a Harness Runtime agent (--type agent) or for Serverless Inference (--type inference), Signals turns collection off for that scope immediately, hides matching conversations from Signals reads immediately, and deletes that conversation data asynchronously in the background. Poll doctl signals deletion get <deletion-id> until the status is complete.

For --type agent, set --environment-id to the agent’s Environment Config ID (the agent UUID). For --type inference, Signals deletes Serverless Inference conversations for your whole team (team-wide; not limited to one endpoint or model) that were collected at or before the deletion request. Do not pass --environment-id for inference.

For an agent deletion, wait until the job is complete before enabling Signals for that agent again. Earlier export files are not deleted and remain available until they expire.

Status values: queued, running, complete, failed. DigitalOcean may retry transient processing errors while a job is still active. If a job ends as failed, matching conversations stay hidden and collection stays off; run create again to retry, and use --format DeletionID,Status,ErrorMessage to see why it failed.

Note: Deletion removes Signals conversation data for the requested scope. Aggregated Insights or metrics charts may still show historical summary datapoints after deletion. Those summaries are not the same as recoverable conversation content.

Flags

Option Description
--help, -h Help for this command
Command Description
doctl signals Display commands for Signals consent, export, and data deletion management
doctl signals deletion create Permanently delete Signals data
doctl signals deletion get Get a Signals deletion job
doctl signals deletion list List Signals deletion jobs

Global Flags

Option Description
--access-token, -t API V2 access token
--api-url, -u Override default API endpoint
--config, -c Specify a custom config file
Default:
    --context Specify a custom authentication context name
    --http-retry-max Set maximum number of retries for requests that fail with a 429 or 500-level error
    Default: 5
    --http-retry-wait-max Set the minimum number of seconds to wait before retrying a failed request
    Default: 30
    --http-retry-wait-min Set the maximum number of seconds to wait before retrying a failed request
    Default: 1
    --interactive Enable interactive behavior. Defaults to true if the terminal supports it (default false)
    Default: false
    --output, -o Desired output format [text|json]
    Default: text
    --show Reveal masked values, such as secrets, instead of hiding them. Values are unmasked automatically in CI
    Default: false
    --trace Show a log of network activity while performing a command
    Default: false
    --verbose, -v Enable verbose output
    Default: false

    We can't find any results for your search.

    Try using different keywords or simplifying your search terms.