Upload Private File

API endpoint for uploading private files. Uploaded files are kept private so that only users with access to the specified Workspace can retrieve them. The endpoint validates the survey ID, file name, and file type from the request body, and returns a signed URL for S3 uploads along with a local upload URL. Note - Environments are deprecated. Use Workspace/workspaceId terminology.

POST /client/{workspaceId}/storage

Upload Private File

cURL

curl --request POST \
  --url https://app.formbricks.com/api/v2/client/{workspaceId}/storage \
  --header 'Content-Type: application/json' \
  --data '
{
  "surveyId": "cm7pr0x2y004o192zmit8cjvb",
  "fileName": "example.jpg",
  "fileType": "image/jpeg"
}
'

200

{
  "data": {
    "signedUrl": "https://s3.example.com/bucket",
    "presignedFields": {
      "key": "uploads/env-id/private/file--fid--uuid.jpg",
      "policy": "<base64-policy>",
      "x-amz-algorithm": "AWS4-HMAC-SHA256"
    },
    "updatedFileName": "file--fid--b153ba3e-6602-4bb3-bed9-211b5b1ae463.jpg",
    "fileUrl": "https://app.formbricks.com/storage/cm1ubebtj000614kqe4hs3c67/private/file--fid--b153ba3e-6602-4bb3-bed9-211b5b1ae463.jpg"
  }
}

Path Parameters

workspaceId · string · required

The ID of the Workspace. Deprecated alias environmentId.

Body

application/json

surveyId · string · required

The ID of the survey associated with the file.

fileName · string · required

The name of the file to be uploaded.

fileType · string · required

The MIME type of the file.

Response

200

application/json

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

data · object

Show child attributes