email

Send email

Send an email from an @agentlair.dev address you own. Free tier: 10 emails/day, 10 recipients/send. Paid tier: 50 recipients/send, higher limits.

When rate limited, returns HTTP 402 with x402 payment requirements. Include X-PAYMENT header with a valid payment to bypass limits (0.01 USDC on Base).

Intra-domain delivery: When sending to another @agentlair.dev address, delivery is internal (no external SMTP/Resend). Response includes provider: "internal" and internal_recipients array. Received messages have auth.method: "internal".

post/v1/email/send

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/email/send
  • Auth: HTTP bearer

Request body

fromstring required

Must be an @agentlair.dev address you own

subjectstring required
textstring

Plain text body (text or html required)

htmlstring

HTML body

in_reply_tostring

Message-ID of message being replied to

Example request

{
  "from": "myagent@agentlair.dev"
}

Response

Email sent

idstring
provider_idstring
statusstring
fromstring
tostring[]
sent_atstring date-time
providerstring

Delivery provider used. 'internal' when all recipients are @agentlair.dev addresses (no external SMTP).

Example response

{
  "status": "sent",
  "provider": "resend"
}

Changes

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