Idempotency

Use a stable key for the same logical send attempt. The mock usage model counts a repeated key once.

Retries

Keep retry state and message identity together. Do not retry permanent failures indefinitely.

Parameters

Proposed code example

// Illustrative only — proposed interface
const response = await mailflow.messages.send({
  projectId: "prj_example",
  to: "recipient@example.com",
  templateId: "tpl_welcome"
});

Illustrative response

{
  "id": "msg_example",
  "status": "accepted",
  "environment": "test"
}

Error response example

{
  "error": {
    "code": "validation_error",
    "message": "A required field is missing."
  }
}