Direct Upload

Direct file upload through API to Azure Blob Storage.

This endpoint streams the file directly from the client through the API server to Azure Blob Storage. Suitable for smaller files (under 10MB).

For larger files, use POST /uploads/url to get a presigned URL and upload directly to Azure Blob Storage from the client.

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

Args: file: File to upload (multipart/form-data) identity: Authenticated API key identity with workspace context

Returns: DirectUploadResponse with storage path and file metadata

Raises: 401: If API key missing or invalid 403: If filename invalid 413: If file exceeds 10MB limit 415: If content_type is missing or not in the configured allowlist 422: If request validation fails 500: If upload to Azure fails

POST /api/integrations/uploads/direct

Direct Upload

cURL

curl --request POST \
  --url https://mm-midmarket-integrations-api-preview.azurewebsites.net/api/integrations/uploads/direct \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'file=<string>'

201

{
  "blobPath": "<string>",
  "sizeBytes": 123,
  "contentType": "<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

multipart/form-data

file · string · required

File to upload (max 10MB)

Response

201

application/json

Successful Response

Response model for direct upload.

blobPath · string · required

Storage path where file was uploaded

sizeBytes · integer · required

Size of uploaded file in bytes

contentType · string · required

MIME type of uploaded file