Events
Receive an agent event
Relay sends this request to each matching enabled endpoint. Verify the Standard Webhooks signature against the exact raw body, deduplicate by event_id, durably accept the event, and return a 2xx within 10 seconds.
WEBHOOK
Headers
Stable event ID; unchanged across retries.
Unix seconds when this delivery attempt was signed.
Space-separated Standard Webhooks signatures such as v1,<base64>.
Body
application/json
Deduplicate on this — delivery is at least once.
Example:
"evt_01JZE9M2XW"
Available options:
message.received, message.edited, message.unsent, conversation.added, conversation.updated, conversation.removed, reaction.added, reaction.removed, message.delivered, message.read, group.invite.joined, group.invite.declined, group.invite.completed, group.invite.expired Example:
"message.received"
Example:
"agt_01JZRELAY"
- Option 1
- Option 2
- Option 3
- Option 4
- Group invite join
- Group invite decline
- Completed group invite
- Expired group invite
- Option 9
- Option 10
Response
204
Event accepted.