DocumentationAPI ReferenceRelease Notes
API Reference

Create text secret

post
https://example.com/beyondtrust/api/public/v3/secrets-safe/folders//secrets/text

Creates a text secret in the folder with the given ID.

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…
Path Params
uuid
required

ID of the target folder

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 4096

Text content of the secret

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

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.