llm.generation_started

A generation run starts for a conversation.

Owner: Conversations. Direction: Travila → your endpoint (outgoing).

The receiver gets an HTTP POST webhook request whose body is the event payload itself. JSON uses protobuf field names (snake_case). See delivery headers and signature verification before accepting it.

Operations that can produce this event

These operations can start the generation workflow that emits this event. Receiving a successful API response does not establish that every event will be produced or delivered.

• Send a message to a conversation — POST /api/v1/llm/send-message
• Send a message and wait for the result — POST /api/v1/llm/send-message-sync

Payload fields

Field	Type	Presence	Meaning
event_context	EventContext	Optional	Event provenance and routing metadata associated with the emitted event.
run_id	string	Optional	Unique identifier for the workflow run
config	GenerationConfig	Optional	Optional snapshot of generation configuration used for this run
starting_sequence	string (int64)	Optional	Conversation sequence number at the moment the run started (if known) Pattern: ^-?\d+$.

Full payload model: LLMGenerationStartedEvent.

Example

Illustrative payload, not a captured delivery. Identifiers, tool names and outcomes are examples; omitted fields depend on the event.

{
  "event_context": {
    "event_name": "llm.generation_started",
    "version": "1.0",
    "event_id": "d3b842c8-b19a-4205-a06f-c57cbf313581",
    "correlation_id": "9d4c2e1f-27b1-4304-ae54-af7fe876df31",
    "emitted_at": "2026-09-16T12:00:00Z",
    "caller_key": "tenant-demo:b81d5345-c1f9-4fb9-b558-a6327c75b842",
    "tenant_id": "tenant-demo",
    "project_id": "default"
  },
  "run_id": "9d4c2e1f-27b1-4304-ae54-af7fe876df31",
  "starting_sequence": "1"
}

Related payloads and delivery

• Event context and identity
• Webhook event catalog and signing
• Receive and process events
• Recover a failed delivery

Download the public reference contract for this event schema and its named example.

Document: DOC-API-EVENT-llm-generation-started.