Skip to main content
POST
/
api
/
v1
/
management
/
storage
Upload Public File
curl --request POST \
  --url https://{baseurl}/api/v1/management/storage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "allowedFileExtensions": [
    "png",
    "jpg",
    "jpeg"
  ],
  "fileName": "profile.png",
  "fileType": "image/png",
  "workspaceId": "env123"
}
'
{
  "data": {
    "fileUrl": "http://localhost:3000/storage/cm1ubebtj000614kqe4hs3c67/public/profile--fid--abc123.png",
    "presignedFields": {
      "Policy": "base64EncodedPolicy",
      "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
      "X-Amz-Credential": "your-credential",
      "X-Amz-Date": "20250312T000000Z",
      "X-Amz-Signature": "your-signature",
      "key": "uploads/public/profile--fid--abc123.png"
    },
    "signedUrl": "https://s3.example.com/your-bucket",
    "updatedFileName": "profile--fid--abc123.png"
  }
}

Documentation Index

Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
x-api-key
string
required

Body

application/json
​
fileName
string
required

The name of the file to be uploaded.

​
fileType
string
required

The MIME type of the file.

​
workspaceId
string
required

The ID of the workspace.

​
allowedFileExtensions
enum<string>[]

Optional. List of allowed file extensions.

Available options:
heic,
png,
jpeg,
jpg,
webp,
ico,
pdf,
eml,
doc,
docx,
xls,
xlsx,
ppt,
pptx,
txt,
csv,
mp4,
mov,
avi,
mkv,
webm,
mp3,
zip,
rar,
7z,
tar

Response

OK - Returns the signed URL, presigned fields, updated file name, and file URL.

​
data
object