v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
email

Ingest a canonical EmailInboundEvent for the given thread. Bypasses the vendor webhook; used by sandbox / replay / direct integrators.

Canonical ingest endpoint.

The path's {thread_id} and the body's event.provider_thread_id must match — defense against accidentally (or maliciously) posting an event whose body claims a different thread than the URL.

post/v1/email/threads/{thread_id}

Path parameters

thread_idstring required

Request body

Response

Successful Response

outcome'reply' | 'observe' | 'archive' | 'drop' | 'duplicate' required
reasonstring nullable
session_idstring uuid nullable
user_turn_idstring uuid nullable
assistant_turn_idstring uuid nullable
draft_idstring uuid nullable
auto_dispatchedboolean