{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Forwards a message from the inbox address right away, with no stored draft. The original message is quoted under a forwarded-message banner, below the optional `html` or `text` note. The attachments of the original message are sent with the forward, together with any `attachments` you add. The request returns a 422 when they exceed 25 MB of `content` in total. An original attachment that was sent from a URL (`path`) cannot be forwarded, and the request returns a 422. The whole email, encoded, can be at most 40 MB, or the request returns a 422.","properties":{"headers":{"type":"object","properties":{"Idempotency-Key":{"type":"string","minLength":1,"maxLength":256,"description":"A unique key for the request, so the forward is sent only once. A retry with the same key within 24 hours returns the first successful (2xx) response, with the `idempotent-replayed: true` header. A failed request is not stored, so it can be retried with the same key. Reusing the key with a different body, or while the first request is still running, returns a 409. An empty key, or one longer than 256 characters, returns a 400 `invalid_idempotency_key`. [Learn more](https://resend.com/docs/dashboard/emails/idempotency-keys)"}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"inbox_id":{"type":"string","examples":["b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1"],"description":"The Inbox ID or the inbox email address, such as `support@acme.com`. A value that contains `@` must be a valid email address, and any other value must be a UUID, or the request returns a 422. The address match is case-insensitive and never falls back to the inbox `name`. An address that matches no inbox returns a 404."},"thread_id":{"type":"string","format":"uuid","description":"The Thread ID."},"email_id":{"type":"string","format":"uuid","description":"The Email ID of the message to forward, as returned in `data[].id` by the list thread emails endpoint."}},"required":["inbox_id","thread_id","email_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/ForwardInboxThreadEmailOptions"}},"required":["path","body"],"additionalProperties":false,"definitions":{"ForwardInboxThreadEmailOptions":{"type":"object","required":["to"],"properties":{"to":{"description":"Recipient email address. For multiple addresses, send as an array of strings. Must name at least one address. `to`, `cc` and `bcc` combined cannot exceed 50 recipients. Each address is `email@example.com` or `Name `. An address that is not valid returns a 422.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}],"examples":[["colleague@example.org"]]},"cc":{"description":"CC recipient email address. For multiple addresses, send as an array of strings. Counts toward the 50-recipient limit. Each address is `email@example.com` or `Name `. An address that is not valid returns a 422.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":50},{"type":"null"}],"examples":[["billing@acme.com"]]},"bcc":{"description":"BCC recipient email address. For multiple addresses, send as an array of strings. Counts toward the 50-recipient limit. Each address is `email@example.com` or `Name `. An address that is not valid returns a 422.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":50},{"type":"null"}],"examples":[["records@acme.com"]]},"html":{"type":"string","description":"An HTML note sent above the quoted original.","examples":["

Flagging this refund request for you.

"]},"text":{"type":"string","description":"A plain-text note sent above the quoted original.","examples":["Flagging this refund request for you."]},"subject":{"type":"string","minLength":1,"maxLength":2000,"description":"The subject of the forward. Cannot be only whitespace or contain a line break. When omitted, the thread subject is used, prefixed with `Fwd:` if it does not already start with it.","examples":["Fwd: Refund for order 1041"]},"attachments":{"type":["array","null"],"description":"Files to attach, as on `POST /emails`. Each one needs `content` or `path`. They share one limit with the attachments of the original message, which the forward also sends. Together they can have at most 25 MB of `content`. A `path` file does not count toward the 25 MB, because it is fetched when the email is sent. An empty file, a blocked file type, a `path` that does not start with `http` or that starts with `http://localhost:`, or a `content_type` that is not a valid MIME type returns a 422. Other `path` problems fail the email when it is sent, not the request.","items":{"$ref":"#/definitions/Attachment"}},"headers":{"type":["object","null"],"additionalProperties":{"type":"string"},"description":"Custom headers to add to the email. The `In-Reply-To`, `References` and `Reply-To` headers are set by Resend and cannot be set here. Sending one of them, in any letter case, returns a 422. Header names cannot be empty, and names and values cannot contain line breaks or null characters, or the request returns a 422. `null` means no custom headers.","examples":[{"X-Ticket-Id":"4821"}]}}},"Attachment":{"type":"object","properties":{"content":{"type":"string","format":"byte","description":"Content of an attached file."},"filename":{"type":"string","description":"Name of attached file."},"path":{"type":"string","description":"Path where the attachment file is hosted"},"content_type":{"type":"string","description":"Optional content type for the attachment, if not set it will be derived from the filename property"},"content_id":{"type":"string","description":"Content ID for embedding inline images using cid references (e.g., cid:image001)."}}}}},"name":"Forward a thread email","id":"resend.inboxes.forward-thread-email","example":{"path":{"inbox_id":"b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1","thread_id":"00000000-0000-4000-8000-000000000000","email_id":"00000000-0000-4000-8000-000000000000"},"body":{"to":["colleague@example.org"]}},"maxRequests":1,"summary":false}}