Delete a credential entry from the Dynatrace Credential Vault by its ID with the Credential Vault API; entries of other users need admin permission.
| DELETE | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/entries/{entry-id} |
You use the entry-id path parameter to permanently delete one credential entry from the vault, for example when an integration no longer needs it or a secret was compromised. Deleting an entry owned by another user requires the credential-vault:entries:admin permission. A 204 response without a body confirms the deletion.
To execute this request, you need a platform token or OAuth access token with credential-vault:entries:write scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| entry-id | string | The ID of the credential entry to be deleted. | path | Required |
| Code | Type | Description |
|---|---|---|
| 204 | - | Success. The credential entry has been deleted. The response doesn't have a body. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ErrorResponseEnvelope objectEncloses the encountered error.
| Element | Type | Description |
|---|---|---|
| error | Error | Basic information of the encountered error. |
ErrorResponse objectBasic information of the encountered error.
| Element | Type | Description |
|---|---|---|
| code | integer | The returned HTTP status code. |
| details | Error | Detailed information of the error. |
| message | string | Description of the encountered error. |
ErrorResponseDetails objectDetailed information of the error.
| Element | Type | Description |
|---|---|---|
| type | string | Defines the actual set of fields depending on the value. See one of the following objects:
The element can hold these values
|
{"error": {"code": 1,"details": {"type": "constraintViolation"},"message": "string"}}