Inbox

POST /api/inbox/{agent_slug}/{code}

Receive Webhook Short

Create a work chat via public webhook inbox (simplified URL without org slug).

Parameters

Name	In	Type	Required	Description
agent_slug	path	string	yes
code	path	string	yes

Responses

Status	Description	Body
201	Successful Response	InboxResponse
422	Validation Error	HTTPValidationError

POST /api/inbox/{org_slug}/{agent_slug}/{code}

Receive Webhook

Create a work chat via public webhook inbox. No authentication required.

Accepts two content types:

• application/json: JSON body with title, description, links, file_urls
• multipart/form-data: form field metadata (JSON string) + file parts

Parameters

Name	In	Type	Required	Description
agent_slug	path	string	yes
code	path	string	yes
org_slug	path	string	yes

Responses

Status	Description	Body
201	Successful Response	InboxResponse
422	Validation Error	HTTPValidationError

POST /api/inbox/hitl/{token}

Receive Hitl Reply

Ingest a human’s email reply to a HITL request (no auth — token + secret).

Resolves the signed reply-address token back to the originating request. If it is still pending, the reply becomes the HITL response and the chat resumes; if it was already answered, the reply continues the conversation as a new message.

Parameters

Name	In	Type	Required	Description
token	path	string	yes

Responses

Status	Description	Body
200	Successful Response	InboxResponse
422	Validation Error	HTTPValidationError