---
title: "Update conversation"
method: POST
path: "/conversation/{conversationId}/update"
tags: ["Conversation"]
---

# Update conversation

`POST /conversation/{conversationId}/update`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/conversation/{conversationId}/update`
- Auth: HTTP bearer

## Path parameters

- `conversationId` string, required

## Request body

- union
  - object: A bot configuration that can be applied without a dedicated bot instance.
    - `name` string: The associated name
    - `description` string: The associated description
    - `meta` Meta: Meta data information
    - `botId` string, nullable: The ID of the bot this configuration is using
    - `contactId` string: The contact id assigned to this conversation
    - `taskId` string: The task id assigned to this conversation
    - `spaceId` string: The space id assigned to this conversation
    - `expiresAt` integer, nullable: Epoch-ms timestamp at which the conversation is automatically deleted; null clears any expiry
  - object: A bot configuration that can be applied without a dedicated bot instance.
    - `name` string: The associated name
    - `description` string: The associated description
    - `meta` Meta: Meta data information
    - `model` string: A model definition
    - `backstory` string, nullable: The backstory this configuration is using
    - `datasetId` string, nullable: The id of the dataset this configuration is using
    - `skillsetId` string, nullable: The id of the skillset this configuration is using
    - `privacy` boolean: The privacy flag for this configuration
    - `moderation` boolean: The moderation flag for this configuration
    - `contactId` string: The contact id assigned to this conversation
    - `taskId` string: The task id assigned to this conversation
    - `spaceId` string: The space id assigned to this conversation
    - `expiresAt` integer, nullable: Epoch-ms timestamp at which the conversation is automatically deleted; null clears any expiry

## Response `200`

The conversation was updated successfully

- object
  - `id` string, required: The ID of the updated conversation

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)