post
https://example.com/beyondtrust/api/public/v3/secrets-safe/folders//secrets/file
Creates a file secret in the folder with the given ID.
Required Permission(s)
Any of the following:
- Secrets Safe (Read)
- Workforce Passwords (Read)
Request Body Details
- Max file size is 5 MB. Size must be greater than 0 MB
- Expects multipart/form-data with:
- secretmetadata: JSON object with the following properties:
- Title (string, required, length: 1-256)
- Description (string, length: 1-256)
- FileName (string, length: 1-256)
- Owners: Array of JSON objects with the following properties:
- UserId OR GroupId (int, required, range: 1-2147483647)
- Notes (string, length: 1-4000)
- file (file content)
- secretmetadata: JSON object with the following properties:
- When adding the file, the form field name must be "secretmetadata". If the name of the form is anything else, the following error occurs: The multipart Request is missing parts: key:'form-data'=True, key:'secretmetadata'=False
- Request body contents:
- Content-Type: application/octet-stream
- Content Part One - name: form-data, type: binary
- Content Part Two - name: secretmetadata, type: string
API Versions
- Version 3.2 - Some properties have been deprecated. Refer to previous documentation versions if using an older API version
