Update managed account credentials by Workgroup Name, Asset Name, and Account Name

put

https://example.com/beyondtrust/api/public/v3/credentials

Updates the credentials for a managed account by Workgroup name, asset name, and managed account name, optionally applying the change to the managed system.

Required Permission(s)

Any of the following:

ISA role
Credentials Manager role
Password Safe Account Management (Full control)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

workgroupName

string

The name of the workgroup containing the asset

assetName

string

The name of the asset (managed system) containing the account

accountName

string

The name of the managed account to update

Body Params

The new credential information

Password

string | null

(optional) The new password to set. If not given, generates a new random password

Credentials

string | null

Password for the account. Implemented for backwards compatibility

PublicKey

string | null

Required if PrivateKey is given and updateSystem = true. The new public key to set on the host

PrivateKey

string | null

The private key to set (provide passphrase if encrypted)

Passphrase

string | null

(optional) The passphrase to use for an encrypted private key

UpdateSystem

boolean

Defaults to true

Whether to update the credentials on the referenced system

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

204

Credentials updated successfully

400Invalid credential data or validation failure

403User lacks required permissions or account role

404Workgroup, asset, or account not found