Generate Upload Url

Generate presigned upload URL for file upload.

Generates a secure, time-limited URL that clients can use to upload files directly to Azure Blob Storage without going through the API server.

Authentication: Requires X-API-Key header with valid workspace-scoped API key. The workspace is automatically determined from the API key.

Args: request_data: Upload URL generation request (filename, content_type) identity: Authenticated API key identity with workspace context

Returns: GenerateUploadUrlResponse with upload URL and metadata

Raises: 401: If API key missing or invalid 403: If filename invalid 415: If content_type is not in the configured allowlist 422: If request validation fails

POST /api/integrations/uploads/url

Generate Upload Url

cURL

curl --request POST \
  --url https://mm-midmarket-integrations-api-preview.azurewebsites.net/api/integrations/uploads/url \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "filename": "<string>",
  "contentType": "<string>"
}
'

200

{
  "uploadUrl": "<string>",
  "blobPath": "<string>",
  "expiresAt": "<string>"
}

Authorizations

X-API-Key · string · header · default: sk_live_your_api_key_here · required

Workspace-scoped API key. Format: sk_live_{64 hex chars}

Body

application/json

Request model for generating upload URL.

filename · string · required

Original filename

Minimum string length: 1

contentType · string · required

MIME type (e.g., video/mp4)

Response

200

application/json

Successful Response

Response model for upload URL generation.

uploadUrl · string · required

Presigned upload URL

blobPath · string · required

Storage path for the uploaded file

expiresAt · string · required

ISO 8601 expiration timestamp