Files
kumomta/docs/reference/events/rebind_message.md
T
Wez Furlong d6eb5176ad docs: remove rapidoc HTTP explorer
It has been replaced by our own static generation.
2026-01-30 16:37:12 +00:00

30 lines
789 B
Markdown

# rebind_message
```lua
kumo.on('rebind_message', function(message, data) end)
```
{{since('2024.09.02-c5476b89')}}
This event is triggered when processing a rebind request that was triggered by
the [/api/admin/rebind/v1](../http/kumod/api_admin_rebind_v1_post.md) HTTP endpoint
(which is is what is used by the `kcli rebind` command).
This event is only triggered when `trigger_rebind_event` is set in the incoming
request.
The purpose of the event is for you to perform an optional, site-specific
modification to the message and/or its metadata in response to the rebind
request.
The `data` parameter is the verbatim `data` field from the request.
```lua
kumo.on('rebind_message', function(msg, data)
if some_condition then
msg:set_meta('queue', data.queue)
end
end)
```