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.
Method: PUT
Endpoint: {{baseURL}}/person/check
Authentication: Bearer {{token}}.
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"
}
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. |