emails

Make a link anyone can open to read one sent or received email, with no sign-in.

It stops working after expires_in (at most 48 hours; default 48 hours). The page shows the message read-only: no script runs, no image or link in it loads.

post/emails/{id}/share

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/emails/{id}/share
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request). Resend-Idempotency-Key is accepted as the same header.

Resend-Idempotency-Keystring

Alias of Idempotency-Key. Idempotency-Key wins if both are sent.

Request body

expires_instring

How long the link stays valid, such as "10m", "2 hours" or "1 day". Default 48h. At most 48 hours.

Response

Success

object'email' required
idstring uuid required

The email the link opens.

urlstring uri required

The link. Anyone who has it can read the email until it expires.

Changes

No recorded changes to this operation across all 1 revision of this API.