DocumentationAPI ReferenceRelease Notes
API Reference

Move secrets and shares to folder

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

Moves secrets and/or shares to the specified destination folder. Supports batch operations and handles naming conflicts through the DuplicateNameAction property.

Required Permission(s)

Any of the following:

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

API Versions

  • Version 3.2 - Includes SecretValueModifiedOn in applicable response models
  • 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…
Body Params

Model data with which to perform the operation

SecretIds
array of uuids
required
length between 0 and 200

List of IDs of secret to move

SecretIds*
ShareIds
array of uuids
required
length between 0 and 200

List of IDs of share to move

ShareIds*
uuid
required
string
required
length ≥ 1
(?i)^(Stop|Rename|Skip)$

Action to take when a duplicate secret/share name is found. Values are:

  • Stop
  • Rename
  • Skip
Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Updated 19 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 19 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.