diff --git a/fern/definition/inboxes/messages.yml b/fern/definition/inboxes/messages.yml index 0603a6f..d572fb3 100644 --- a/fern/definition/inboxes/messages.yml +++ b/fern/definition/inboxes/messages.yml @@ -61,10 +61,22 @@ service: display-name: Get Raw Message path-parameters: message_id: messages.MessageId - response: file + response: messages.RawMessageResponse errors: - global.NotFoundError + update: + method: PATCH + path: /{message_id} + display-name: Update Message + path-parameters: + message_id: messages.MessageId + request: messages.UpdateMessageRequest + response: messages.Message + errors: + - global.ValidationError + - global.NotFoundError + send: method: POST path: /send @@ -114,15 +126,3 @@ service: - global.ValidationError - global.NotFoundError - messages.MessageRejectedError - - update: - method: PATCH - path: /{message_id} - display-name: Update Message - path-parameters: - message_id: messages.MessageId - request: messages.UpdateMessageRequest - response: messages.Message - errors: - - global.ValidationError - - global.NotFoundError diff --git a/fern/definition/messages.yml b/fern/definition/messages.yml index e04bc3e..4f89b6f 100644 --- a/fern/definition/messages.yml +++ b/fern/definition/messages.yml @@ -145,6 +145,22 @@ types: type: list docs: Ordered by `timestamp` descending. + RawMessageResponse: + docs: Signed URL to download the raw .eml file. Uses CloudFront signing, same as attachments. + properties: + message_id: + type: MessageId + docs: ID of the message. + size: + type: MessageSize + docs: Size of the raw message in bytes. + download_url: + type: string + docs: Pre-signed CloudFront URL to download the raw message. Expires at expires_at. + expires_at: + type: datetime + docs: Time at which the download URL expires. + Addresses: discriminated: false union: diff --git a/fern/docs.yml b/fern/docs.yml index 0f9500f..0de7a0d 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -186,8 +186,6 @@ redirects: destination: /custom-domains - source: /best-practices/email-deliverability destination: /email-deliverability - - source: /api-reference/inboxes/messages/get-raw-message - destination: /api-reference/inboxes/messages/get-raw - source: /webhook/agentmail destination: /webhook-verification - source: /get-started/quickstart diff --git a/fern/pages/core-concepts/messages.mdx b/fern/pages/core-concepts/messages.mdx index bfdb6c3..1aac9db 100644 --- a/fern/pages/core-concepts/messages.mdx +++ b/fern/pages/core-concepts/messages.mdx @@ -235,6 +235,7 @@ Copy one of the blocks below into Cursor or Claude for complete Messages API kno * - messages.forward(inboxId, messageId, { to, subject?, text?, html? }) * - messages.update(inboxId, messageId, { addLabels?, removeLabels? }) * - messages.getAttachment(inboxId, messageId, attachmentId) + * - messages.getRaw(inboxId, messageId) -> { message_id, size, download_url, expires_at } (CloudFront signed URL for .eml) * - messages.getRaw(inboxId, messageId) * * Reply content: use extractedText/extractedHtml for new content without quoted history.