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)
• 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 - Includes SecretValueModifiedOn in applicable response models
• Version 3.1 - Using Owners collection
• Version 3.0 - Using obsolete owner properties