Generate Presigned URL

Generates a presigned S3 URL for uploading a file/attachment associated with a specific check on a person's order. The returned uploadUrl can then be used to upload the file directly to cloud storage (e.g., S3) without requiring additional authentication.


Request Details

Method: PUT
Endpoint: {{baseURL}}/person/check
Authentication: Bearer {{token}}.


Request Body

The request body must be sent as raw JSON (application/json):

Parameter Type Description
orderCheckId string The unique identifier of the order check. Sourced from the {{checkId}} collection variable.
checkShortName string The short name/identifier of the check type. Sourced from the {{checkName}} collection variable.
attachmentShortName string The short name identifying the type of attachment (e.g., panCard).
fileName string The name of the file to be uploaded (e.g., millowlogo.png).
contentType string The MIME type of the file being uploaded (e.g., image/png).
fileCaption string The additional information about the file. (optional)

Example Body:

{
  "orderCheckId": "{{checkId}}",
  "checkShortName": "{{checkName}}",
  "attachmentShortName": "panCard",
  "fileName": "millowlogo.png",
  "contentType": "image/png"
}


Response

Success — 200 OK

Returns a presigned URL that can be used to upload the file directly.

{
  "uploadUrl": "https://..."
}

Field Type Description
uploadUrl string A presigned URL for uploading the file to cloud storage. Valid for a limited time.