---
title: "Call AI Gather Message History Updated"
method: POST
path: "CallAIGatherMessageHistoryUpdated"
tags: ["Callbacks"]
---

# Call AI Gather Message History Updated

`POST CallAIGatherMessageHistoryUpdated` (webhook)

This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.

## Headers

- `telnyx-timestamp` integer, required — Unix timestamp for replay attack prevention
- `telnyx-signature-ed25519` string, required — Ed25519 signature of timestamp|payload for verification

## Payload

- CallAIGatherMessageHistoryUpdatedEvent
  - `data` CallAIGatherMessageHistoryUpdated
    - `record_type` 'event' — Identifies the type of the resource.
    - `event_type` 'call.ai_gather.message_history_updated' — The type of event being delivered.
    - `id` string, uuid — Identifies the type of resource.
    - `occurred_at` string, date-time — ISO 8601 datetime of when the event occurred.
    - `payload` object
      - `call_control_id` string — Call ID used to issue commands via Call Control API.
      - `connection_id` string — Telnyx connection ID used in the call.
      - `call_leg_id` string — ID that is unique to the call and can be used to correlate webhook events.
      - `call_session_id` string — ID that is unique to the call session and can be used to correlate webhook events. Call session is a group of related call legs that logically belong to the same phone call, e.g. an inbound and outbound leg of a transferred call.
      - `client_state` string — State received from a command.
      - `from` string — Number or SIP URI placing the call.
      - `to` string — Destination number or SIP URI of the call.
      - `message_history` object[] — The history of the messages exchanged during the AI gather
        - `content` string — The content of the message
        - `role` 'assistant' | 'user' — The role of the message sender

## Acknowledgement `200`

The server must return an HTTP 200, otherwise we will reattempt delivery at the failover webhook URL.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)