Update conversation metadata

PUT 
/ai/conversations/:conversation_id

Update metadata for a specific conversation.

Path Parameters

conversation_id stringrequired

The ID of the conversation to update

application/json

Body

required

metadata

object

Metadata associated with the conversation.

property name* string

Metadata associated with the conversation.

200: Successful Update

application/json

• Schema
• Example (from schema)

Schema

data

object

id uuidrequired

name string

created_at date-timerequired

The datetime the conversation was created.

metadata

object

required

Metadata associated with the conversation. Telnyx provides several pieces of metadata, but customers can also add their own.

property name* string

Metadata associated with the conversation. Telnyx provides several pieces of metadata, but customers can also add their own.

last_message_at date-timerequired

The datetime of the latest message in the conversation.

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

404: Conversation Not Found

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L -X PUT 'https://api.telnyx.com/v2/ai/conversations/:conversation_id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "metadata": {}
}'

Response samples

• 200
• 422

---

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

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}