Summary
The API used to upload draft email attachments is being deprecated and replaced with a new upload mechanism.
The previous upload method relied on a multipart PUT request that was not compatible with the Genesys Cloud SDKs. The new upload process provides a more reliable, secure, and scalable approach.
Legacy API
- POST uploads/postino-attachments
Replacement API
- POST /api/v2/conversations/emails/{conversationId}/messages/draft/attachments/uploads
The new upload workflow is:
- Call POST /api/v2/conversations/emails/{conversationId}/messages/draft/attachments/uploads to generate a pre-signed Amazon S3 upload URL.
- Upload the attachment by sending a PUT request directly to the returned pre-signed S3 URL.
- Once the upload completes successfully, the attachment is automatically available in the email draft.
Complete implementation guidance is available in the Genesys Cloud Developer Center.
Effective Date
Monday, July 27, 2026
Details
This change introduces a modern media upload service that provides improved reliability, scalability, and SDK compatibility compared to the previous upload mechanism.
Customer Impact
Customers currently uploading email attachments through the deprecated API must migrate to the new attachment upload API.
The legacy upload API will be removed following the deprecation period.
Customer Action Required
Customers should update any integrations, applications, SDK implementations, or automation that upload draft email attachments to:
- Stop using
POST uploads/postino-attachments.
- Implement the new upload workflow using:
POST /api/v2/conversations/emails/{conversationId}/messages/draft/attachments/uploads
- Upload the file using the returned pre-signed S3 URL.
Migrating before the removal date will ensure uninterrupted email attachment uploads.
Impacted Resources
Deprecated
POST uploads/postino-attachments
Replacement
POST /api/v2/conversations/emails/{conversationId}/messages/draft/attachments/uploads
Issue References
POSTINO-3306
POSTINO-3634
PLATFORM-4505
Contacts
@Milan Vrenjak Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.