Error Codes

Reference for error codes returned by the RelayRail API.

Authentication Errors

Code	Description
`RATE_LIMITED`	Too many requests, slow down
`QUOTA_EXCEEDED`	Daily/monthly quota exceeded
`SMS_LIMIT_REACHED`	SMS quota exhausted for billing period

Code	Description
`INVALID_PARAMS`	Missing or invalid parameters
`REQUEST_NOT_FOUND`	Approval request doesn't exist
`REQUEST_EXPIRED`	Approval request has timed out
`REQUEST_ALREADY_RESPONDED`	Request was already answered

Code	Description
`SMS_DELIVERY_FAILED`	SMS could not be delivered
`EMAIL_DELIVERY_FAILED`	Email could not be delivered
`NO_CONTACT_METHOD`	User has no phone or email configured

Errors are returned in the tool response:

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please wait 60 seconds."
  }
}

Your agent should check the success field and handle errors appropriately.