---
title: "Update a Specific Conversation by ID"
method: PUT
path: "/v1/conversations/{conversation_id}"
tags: ["Conversations"]
---

# Update a Specific Conversation by ID

`PUT /v1/conversations/{conversation_id}`

Update a Specific Conversation by ID

## Path parameters

- `conversation_id` string, required — ID of the conversation

## Request body

- ConversationInput
  - `source` string, required — Source from where the conversation originated. This can be device id, phone number, etc.
  - `sourceType` 'BROWSER' | 'TWILIO' | 'PLIVO', required
  - `agentId` string, required — AI agent which handled the conversation
  - `transcriptText` DialogLine[], nullable — URL to the full transcript of the conversation
    - `speaker` string, required
    - `message` string, required
    - `timestamp` string, date-time, required
    - `message_id` string, required
  - `transcriptSummary` string, nullable — Summary of the conversation
  - `transcriptRecordingUrl` string, nullable — URL to the recording of the conversation
  - `timestampStart` string, date-time, required — Start time of the conversation
  - `timestampEnd` string, date-time, nullable — End time of the conversation
  - `conversationAnalytics` ConversationAnalyticsModel — Expected output of the post conversation task
    - `summary` string, required — Summary of the conversation happened with important details on the conversation. The summary should be concise and to the point. It should contain the important details of the conversation like name, phone number, email, address and any other details shared by the user.
    - `action_items` string[], nullable, required — List of action items and the next steps to be performed from the conversation details.
    - `is_audio_consent_given` boolean, required — If the user has given consent to store the audio of the conversation. Unless the user explicitly says yes, this should be false.
    - `email_address_of_caller` string, nullable, required — Extracted email address of the caller from the conversation details. Email should be a valid email address format
    - `name_of_caller` string, nullable, required — Extracted name of the caller from the conversation details.
    - `phone_number_of_caller` string, nullable, required — Extracted phone number of the caller from the conversation details.
    - `address_of_caller` string, nullable, required — Extracted address of the caller from the conversation details.
    - `sentiment_of_caller` 'positive' | 'negative' | 'neutral', required
    - `prospectStatus` 'NEW' | 'GENERAL_ENQUIRY' | 'SCHEDULED_CALLBACK_WITH_BOT' | 'SCHEDULED_APPOINTMENT_WITH_PERSON' | 'SCHEDULED_APPOINTMENT_FOR_SERVICE' | 'NOT_INTERESTED' | 'PRODUCT_ORDER_PLACED' | 'SERVICE_ORDER_PLACED', required
  - `adminComments` Comment[], nullable — Comments from the admin on the conversation
    - `comment` string, required — Notes or comments to record
    - `rating` integer, required — Star rating to record

## Response `200`

Conversation updated successfully

- ConversationOutput — Any conversation happening between the end user and assistant is stored in this table
  - `id` string
  - `orgId` string
  - `prospectId` string, nullable
  - `source` string
  - `sourceType` string
  - `aiAgentId` string
  - `transcriptText` DialogLine[], nullable
    - `speaker` string, required
    - `message` string, required
    - `timestamp` string, date-time, required
    - `message_id` string, required
  - `transcriptSummary` string, nullable
  - `transcriptRecordingUrl` string, nullable
  - `timestampStart` string, date-time
  - `timestampEnd` string, date-time, nullable
  - `conversationAnalytics` ConversationAnalyticsModel — Expected output of the post conversation task
    - `summary` string, required — Summary of the conversation happened with important details on the conversation. The summary should be concise and to the point. It should contain the important details of the conversation like name, phone number, email, address and any other details shared by the user.
    - `action_items` string[], nullable, required — List of action items and the next steps to be performed from the conversation details.
    - `is_audio_consent_given` boolean, required — If the user has given consent to store the audio of the conversation. Unless the user explicitly says yes, this should be false.
    - `email_address_of_caller` string, nullable, required — Extracted email address of the caller from the conversation details. Email should be a valid email address format
    - `name_of_caller` string, nullable, required — Extracted name of the caller from the conversation details.
    - `phone_number_of_caller` string, nullable, required — Extracted phone number of the caller from the conversation details.
    - `address_of_caller` string, nullable, required — Extracted address of the caller from the conversation details.
    - `sentiment_of_caller` 'positive' | 'negative' | 'neutral', required
    - `prospectStatus` 'NEW' | 'GENERAL_ENQUIRY' | 'SCHEDULED_CALLBACK_WITH_BOT' | 'SCHEDULED_APPOINTMENT_WITH_PERSON' | 'SCHEDULED_APPOINTMENT_FOR_SERVICE' | 'NOT_INTERESTED' | 'PRODUCT_ORDER_PLACED' | 'SERVICE_ORDER_PLACED', required
  - `status` string, required
  - `createdBy` string
  - `createdAt` string, date-time
  - `updatedBy` string
  - `updatedAt` string, date-time

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tratahq/apis/trata-ai-api.md) · [All operations](https://skmtc.net/tratahq/apis/trata-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tratahq/trata-ai-api/revisions/8f7b69ee5a90/schema)