email_rate_limited

HTTP status: 429 · Code: email_rate_limited

The project sent too many emails through the install’s SMTP server this hour; wait for Retry-After.

Why it happens

The project sent more emails through the install’s SMTP server this hour than the install allows (ORVANO_EMAIL_INSTALL_HOURLY_LIMIT, 200 by default). The limit protects the install’s sending reputation.

How to fix

Wait for the number of seconds in Retry-After. For more mail, give the project its own SMTP server, which has no install cap, or raise the setting on your install.

Catch it in your code

Every SDK throws one error type for a failed call. Match on its code, which is always email_rate_limited for this error, never on the message.

JavaScript and Next.js

import { ErrorCode, OrvanoError } from '@orvano/js'

try {
  // your Orvano call
} catch (error) {
  if (error instanceof OrvanoError && error.code === ErrorCode.emailRateLimited) {
    // handle email_rate_limited
  } else {
    throw error
  }
}

Dart and Flutter

import 'package:orvano_flutter/orvano_flutter.dart'; // or orvano_dart on a server

try {
  // your Orvano call
} on OrvanoException catch (error) {
  if (error.code != ErrorCode.emailRateLimited) rethrow;
  // handle email_rate_limited
}

.NET

using Orvano;

try
{
    // your Orvano call
}
catch (OrvanoException error) when (error.Code == ErrorCode.EmailRateLimited)
{
    // handle email_rate_limited
}

The error also carries the HTTP status (429), a message, and a request ID. Quote the request ID when you report a problem: the server logs it with the failure. See Errors for how errors work in every SDK, or every error code.