v53

OpenAPI 3.1.0raw.githubusercontent.com2026-08-041,1941,9384.1 MB

Conversations

Update conversation metadata

Update metadata for a specific conversation.

put/ai/conversations/{conversation_id}

Path parameters

conversation_idstring required

The ID of the conversation to update

Request body

metadataobject

Metadata associated with the conversation. Set ai_disabled to true to stop AI from responding to messages (e.g., when a human agent takes over). Set to false to re-enable AI responses.

Response

Successful Update

Example response

{
  "data": {
    "created_at": "2025-04-15T13:07:28.764Z",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "last_message_at": "2025-04-15T13:07:28.764Z",
    "metadata": {
      "assistant_id": "assistant-123",
      "telnyx_agent_target": "+13128675309",
      "telnyx_conversation_channel": "sms",
      "telnyx_end_user_target": "+13128675309"
    }
  }
}