Update an inbound route
PATCH
/v1/email/inbound-routes/{route_id}
curl -X PATCH "https://us1.platform.bird.com/v1/email/inbound-routes/{route_id}" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"priority": 50
}'Updates an inbound route. The domain is immutable. Disabled routes are kept but skipped during evaluation.
Corpo da requisição
match_type
string
How the route matches recipients.
match_value
nullable string
The local part an address route matches. Null for catch_all routes.
action
string
What happens to matching mail. deliver_to_mailbox requires target_mailbox_id.
target_mailbox_id
nullable string
The mailbox that receives matching mail. Null for drop routes.
priority
integer
Evaluation order — lowest number wins. Explicit routes accept 11–1000; the mailbox's own address always matches at priority 10.
enabled
boolean
Whether the route is evaluated.
Payload de resposta
id
string
obrigatório
Inbound route ID.
domain
string
obrigatório
The domain the route applies to.
match_type
string
obrigatório
How the route matches recipients. address matches one local part; catch_all matches every recipient on the domain that nothing else matched.
match_value
nullable string
obrigatório
The local part an address route matches. Null for catch_all routes.
action
string
obrigatório
What happens to matching mail.
target_mailbox_id
nullable string
obrigatório
The mailbox that receives matching mail. Null for drop routes.
priority
integer
obrigatório
Evaluation order — lowest number wins. Explicit routes accept 11–1000 (default 100); the mailbox's own address always matches at priority 10.
enabled
boolean
obrigatório
Whether the route is evaluated. Disabled routes are kept but skipped.
created_at
string
obrigatório
When the route was created.
updated_at
string
obrigatório
When the route was last updated.