DocumentationAPI ReferenceRelease Notes
API Reference

Update credential secret

put
https://example.com/beyondtrust/api/public/v3/secrets-safe/secrets/

Updates a secret based on the given ID.

Required Permission(s)

Any of the following:

  • Secrets Safe (Read)
  • Workforce Passwords (Read)

API Versions

  • Version 3.1 - Using Owners collection
  • Version 3.0 - Using obsolete owner properties
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID of the secret

Query Params
string
Defaults to 3.0

API version for response format

Body Params

Model data with which to perform the operation

string
required
length between 0 and 256

Credential username

string | null

Credential password

int32 | null
0 to 32767

Password will be auto-generated using the specified password policy

string
required
length between 0 and 256

Title of the secret

string | null

Additional information relevant to the secret

Owners
array of objects | null

List of owners of the secret

Owners
string | null

Notes relevant to the secret

Urls
array of objects | null

List of URLs relevant to the secret

Urls
Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses
204

No content when successful

Updated 20 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 20 days ago

©2003-2026 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.