Skip to main content

Stop managing an account, optionally removing its host user

DELETE 
/api/v1/ManagedUser/:id

Removes the managed user record so the account is no longer managed. It also removes the account's scheduled jobs, marks the host user as not managed, and, for accounts without dependencies, renames the stored credential and removes it from credential access policies. If the account is managed through a resource group, those other steps are skipped, but the managed user record is still removed and the call returns 200. When deleteHostUser is true, the host user record linked to it is also marked as deleted. Returns the id that was passed in.

Permission required: Administrator or application role.

Caution: This call takes effect immediately, and with deleteHostUser set to true it also deletes the host user record. For an account managed through a resource group, the record is removed but its scheduled jobs and resource group membership are left in place.

Request​

Responses​

The managed user was removed, or was not found and ignoreNotFound is true. The body is the id.