MinMaxHub API
Image and file upload pipeline via S3 presigned URLs.
Get a presigned URL for image upload
POST
{apiBaseUrl}
/media/presign
Generates an S3 presigned URL for uploading an image. The image is associated with a specific entity and topic. Accepted content types are JPEG, PNG, and WebP. Returns both the upload URL and the final public image URL. Requires authentication.
Get a presigned URL for image upload › Request Body
Request body for generating an S3 presigned upload URL.
entityIdEntity the image is associated with
topicKeyTopic key the image belongs to
contentTypeMIME type of the image to upload
Enum values:
image/jpeg
image/png
image/webp
itemKeyOptional item key for collection-type topics
Get a presigned URL for image upload › Responses
Presigned URL generated successfully
Standard response envelope wrapping all API responses. Every response includes a trace ID for debugging, a machine-readable status, and a human-readable message.
statusMachine-readable status code
Enum values:
OK
CREATED
ACCEPTED
NO_CONTENT
BAD_REQUEST
UNAUTHORIZED
FORBIDDEN
NOT_FOUND
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
object
Presigned URL details for uploading an image to S3.