Try it free

Cancel or delete a OneAgent support archive

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Cancel a OneAgent support archive that is still being collected, or delete a finished one, in Dynatrace with the Fleet Management API.

DELETESaaShttps://{your-environment-id}.apps.dynatrace.com/v1/oneagent/support-archives/{smartscape-node-id}/{support-archive-id}

Overview

You use the smartscape-node-id and support-archive-id path parameters to choose a support archive for a OneAgent. If the archive is still being collected, the operation requests cancellation; if collection has finished, it deletes the archive. A 204 response without content confirms the request.

Authentication

To execute this request, you need a platform token or OAuth access token with fleet-management:oneagent.support-archives:delete scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
smartscape-node-idstring

The Smartscape node ID of the entity. Valid node types: ONEAGENT, PROCESS.

pathRequired
support-archive-idstring

The ID of the support archive.

pathRequired

Response

Response codes

CodeTypeDescription
204-

No content. Cancellation requested (if collecting) or deleted (if finished).

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code

constraintViolationsConstraintViolation[]

A list of constraint violations

messagestring

The error message

The ConstraintViolation object

A list of constraint violations

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
"error": {
"code": 1,
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
],
"message": "string"
}
}
Related tags
Platform APIDynatrace Platform