# Get a presigned S3 upload URL for large files

Returns a presigned S3 PUT URL for uploading ZIP files that exceed the 10 MB direct upload limit.
The URL is valid for 10 minutes. After uploading to S3, pass the returned s3_key to POST /v2/fraudscanner.

Flow:

1. POST /v2/getUploadUrl → receive upload_url + s3_key
2. PUT your ZIP to upload_url (with Content-Type: application/zip)
3. POST /v2/fraudscanner?s3_key= → receive analysis results

The uploaded file is automatically deleted after processing (or after 24h if not consumed).

Endpoint: POST /v2/getUploadUrl
Version: v2.5.0
Security: apiKeyAuth

## Header parameters:

  - `x-api-key` (string, required)
    The API key for authentication.

## Response 200 fields (application/json):

  - `upload_url` (string, required)
    Presigned S3 PUT URL. Upload your ZIP file here using an HTTP PUT request with Content-Type application/zip. Expires after 10 minutes.
    Example: "https://s3.eu-central-1.amazonaws.com/vh-fs-large-uploads-prod/uploads/company123/a1b2c3d4.zip?..."

  - `s3_key` (string, required)
    The S3 key to pass as query parameter to POST /v2/fraudscanner after uploading.
    Example: "uploads/company123/a1b2c3d4.zip"

## Response 429 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."