Skip to main content

delete-report

dci delete-report <id>

Deletes the specified Cloud Analytics report.

  • id — Report ID or name as shown by dci list-reports. Interactive terminals ask for confirmation and show the resolved name and ID before deleting.

Examples

# Delete a report by name (a confirm dialog shows the resolved report; Cancel is the default).
dci delete-report "Old draft"
# Preview locally what would be deleted, without sending a request.
dci delete-report <report-id> --dry-run
# Delete without a prompt, for scripts and CI (exit code 30 if confirmation is missing).
dci delete-report <report-id> --yes

Output

OK - Report deleted.

By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.

Returns: object

Example response (--output json)

{}
Raw JSON schema
{
"type": "object",
"additionalProperties": false
}

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 statusExit codeError codeMeaning
40030VALIDATION_ERRORThe arguments or request body were rejected. Review the command's flags and payload.
40110AUTHENTICATION_FAILEDNot signed in, or the API token is invalid. Run dci login or check DCI_API_KEY.
40311PERMISSION_DENIEDThe DoiT user or the active customer context does not have access.
40420RESOURCE_NOT_FOUNDThe requested resource does not exist. Check the identifier argument.
50040API_SERVER_ERRORThe API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: deletereport