Skip to content

Delete AWS Role Cloud Account



POST /api/v1/cloud_account/{cloud_account_uuid}/do/delete

Path Parameters

Parameter Name Type Required Description
cloud_account_uuid string Y Cloud account UUID
Allow empty string: False

Additional Parameter Notes

For end-to-end steps, see Connect an AWS Cloud Account via OpenAPI. The Endpoint in the example is taken from the OpenAPI Site List.

Only AWS assume_role in the current workspace is supported. The cloudAccount.accountManage permission is required, and the body must be {}.

Deletion follows Front behavior: soft-delete the cloud account, remove associated collectors and tasks, and do not delete historical observability data or the customer AWS IAM Role. Enqueuing a private Func does not mean uninstallation has completed. Before executing, confirm the target UUID and associated collectors; if collection needs to be retained, stop the deletion.

Repeated deletion returns the original not-found error and does not automatically become successful. Recreating after deletion generates a new UUID/External ID. The customer must reconfigure the trust policy and collectors, and the old request results cannot be restored. The customer Role is managed by the customer, and the platform does not automatically roll back across AWS.

Request Example

curl -X POST '<Endpoint>/api/v1/cloud_account/<cloud_account_uuid>/do/delete' -H 'DF-API-KEY: <DF-API-KEY>' -H 'Content-Type: application/json' --data-raw '{}'

Response

{
    "code": 200,
    "success": true,
    "errorCode": "",
    "message": "",
    "content": {
        "uuid": "clac_example",
        "declaration": {}
    },
    "traceId": "TRACE-example"
}