DocumentationAPI ReferenceRelease Notes
API Reference

Update safe permissions by ID

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

Assigns or updates permissions for a user or group on a specific safe.

Required Permission(s)

  • Secrets Safe (Manage)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Unique GUID identifier of the safe

Body Params

Permission assignment model containing principal type, ID, and permission flags

int32
required

0 for user, 1 for group

int32
required

ID of the user or group

PermissionFlags
array of strings | null

Permissions to assign to the principal on the safe

PermissionFlags
date-time | null

Expiry for the given permissions

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses
204

Permissions assigned successfully

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.