Get the current status of a record deletion request in Dynatrace with the Grail Storage Record Deletion API, including progress and final outcome.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/storage/record/v1/delete:status |
Returns the current status of a record deletion process. Possible statuses:
submitted: deletion is queued, not yet started.
processing: deletion is in progress; the progress field shows the percentage of segments
processed.
finished: all records were successfully deleted.
incomplete: deletion finished with partial failures; some segments could not be rewritten.
failed: deletion failed completely.
cancelled: deletion was cancelled before processing started.
unknown: no deletion task found for the provided ID.
To execute this request, you need a platform token or OAuth access token with storage:records:delete scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| body | Deleted | Status request | body | Required |
DeletedRecordsProcess object| Element | Type | Description | Required |
|---|---|---|---|
| taskId | string | - | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"taskId": "49eb7d8e-806a-4829-9d29-c2a92e642366"}
| Code | Type | Description |
|---|---|---|
| 200 | Status | Successfully returned status of the record deletion process. |
| 400 | Error | Bad request for requesting status of the record deletion process. |
| 401 | Error | Unauthorized. |
| 403 | Error | Access forbidden. |
StatusDeleteRecordsResponse object| Element | Type | Description |
|---|---|---|
| message | string | - |
| progress | string | - |
| rewrittenBytes | integer | - |
| status | string | -The element can hold these values
|
| submittedAt | string | - |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Exceptional | - |
ExceptionalReturn object| Element | Type | Description |
|---|---|---|
| code | integer | - |
| errorDetails | (Custom | - |
| message | string | - |
CustomValidationErrorInfo objectErrorInfo object| Element | Type | Description |
|---|---|---|
| message | string | - |
InvalidAuditEventsErrorInfo objectMediaTypeErrorInfo objectParameterErrorInfo objectProxyErrorInfo objectQueryFrontendRawErrorInfo objectRequestBodyErrorInfo object{"status": "cancelled","message": "Deletion of records cancelled.","submittedAt": "2026-04-01T03:15:12Z","rewrittenBytes": 0}
{"error": {"code": 1,"errorDetails": [{"message": "string"}],"message": "string"}}