Update Inbound Route

post

https://api.aurorasendcloud.com/api/route/update

Update an existing route configuration by route ID. Full overwrite: expression and action are required and replace the stored values (no partial update). Domain validation follows the expression suffix only — the action URL's host is NOT validated (an action pointing at a non-existent or foreign domain is accepted as long as the expression domain passes). apiUserRoute is required if the updated action is an email address (and is reset to null when the updated action is a URL). The resulting route must not duplicate another existing route (42012).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Form Data

routeId

integer

required

Route ID (unique identifier for the route to modify). Required: missing returns 42001; a routeId not existing under the account returns 42002. Non-numeric input fails Spring Integer binding and returns a framework 501 server error before business validation.

expression

string

required

length ≤ 128

Updated receiving route. Required, same constraints as add: 1-128 characters (42007); must contain '@' (42007); must be a compilable regular expression (42007); suffix after last '@' must be a non-blank domain (42003) existing under the account (42004) and available (42005; MX verified required when action is an email address).

action

string

required

length ≤ 255

Updated target URL or email address. Required, same constraints as add: 1-255 characters (42009); http(s) URL matching the source URL pattern or a valid email address (42009 otherwise). Email action requires apiUserRoute (42010); URL action resets apiUserRoute to null.

apiUserRoute

string

Required when the updated action is set to an email address; must be an existing API_USER under the account (42011 otherwise). Ignored (reset to null) when the updated action is a URL.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Request successful

400Business failure. HTTP status is 200 in the actual response body convention; the codes below are the statusCode values returned with result=false.