delete-report
dci delete-report <id>
Deletes the specified Cloud Analytics report.
id— Report ID or name as shown bydci 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 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. |
| 404 | 20 | RESOURCE_NOT_FOUND | The requested resource does not exist. Check the identifier argument. |
| 500 | 40 | API_SERVER_ERROR | The API failed to process the request. Retryable; contact DoiT support if it persists. |
Related
- list-reports — List reports
- get-report — Get report results
- create-report — Create a report
- update-report — Update a report
- API reference: DELETE /analytics/v1/reports/{id}
Aliases: deletereport