{
"data": {
"message": "<string>",
"message_id": "<string>",
"thread_id": "<string>",
"user_id": "<string>",
"attachments": [
{
"mime_type": "<string>",
"name": "<string>",
"url": "<string>"
}
]
},
"id": "<string>",
"occurred_at": "2023-11-07T05:31:56Z",
"type": "message.before_submit.v1",
"workspace_id": "<string>",
"project_id": "<string>"
}{
"decision": "allow",
"reason": "<string>"
}Hooks
Before message submission
Return a decision from your HTTPS endpoint before this action continues.
{
"data": {
"message": "<string>",
"message_id": "<string>",
"thread_id": "<string>",
"user_id": "<string>",
"attachments": [
{
"mime_type": "<string>",
"name": "<string>",
"url": "<string>"
}
]
},
"id": "<string>",
"occurred_at": "2023-11-07T05:31:56Z",
"type": "message.before_submit.v1",
"workspace_id": "<string>",
"project_id": "<string>"
}{
"decision": "allow",
"reason": "<string>"
}Set up Events & Hooks.
Checks a user message before it is queued or sent to the agent. Includes the sender, message text, and attachments, but not conversation history.
Destinations share a five-second deadline and are not retried. Any
deny blocks submission. Errors and invalid responses follow the subscription’s configured failure behavior. Subscription discovery failures block submission.
Return HTTP 200 with application/json and an allow or deny decision (maximum 64 KiB). See signature verification.Headers
Invocation ID. Each matching subscription receives a distinct ID.
Integer Unix timestamp in seconds for this delivery attempt.
Pattern:
^[0-9]+$Symmetric (v1) signatures as defined by Standard Webhooks.
Body
application/json
Show child attributes
Show child attributes
Hook execution identity shared by all matching subscriptions.
Available options:
message.before_submit.v1 Absent for workspace chats. Referencing a project does not make a message project-scoped.
Was this page helpful?