---
title: "Receive a conversation response"
method: POST
path: "/conversation/{conversationId}/receive"
tags: ["Conversation"]
---

# Receive a conversation response

`POST /conversation/{conversationId}/receive`

## Request

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

## Path parameters

- `conversationId` string, required: The ID of the conversation to receive message from

## Request body

- object
  - `functions` object[]: An array of functions to be added to the conversation
    - `name` string, required: The name of the function (must be a valid JS identifier, max 64 chars)
    - `description` string, required: The description of the function
    - `parameters` object, required: JSON Schema definition for the function parameters
      - `type` 'object', required: The schema type, must be "object"
      - `properties` object, required: Object property definitions
      - `required` string[]: Required property names
    - `result` union: The result of the function execution
      - object
        - `data` unknown, required
      - object
        - `channel` string, required: The channel for streaming function results
    - `call` object: Configuration for when this function should be automatically called
      - `start` boolean: If true, this function will be force-called at the start of the conversation
      - `end` boolean: If true, this function will be force-called at the end of the conversation
  - `extensions` ExtensionsDefinition: Extensions to enhance the bot's capabilities
    - `backstory` string: Additional backstory for the bot
    - `datasets` object[]: Inline datasets to provide additional context
      - `name` string, nullable: The name of the dataset
      - `description` string, nullable: The description of the dataset
      - `records` object[], required: The records in the dataset
        - `text` string, required: The text content of the record
        - `meta` object: Additional metadata for the record
    - `skillsets` object[]: Inline skillsets to provide additional abilities
      - `name` string, nullable: The name of the skillset
      - `description` string, nullable: The description of the skillset
      - `abilities` object[], required: The abilities in the skillset
        - `name` string, required: The name of the ability
        - `description` string, required: The description of the ability
        - `instruction` string, required: The instruction for the ability
        - `linkedSecretId` string: Optional secret ID for the ability
        - `linkedSpaceId` string: Optional space ID for the ability
        - `meta` object: Additional metadata for the ability
    - `features` object[]: Feature flags to enable specific bot capabilities
      - `name` string, required: The name of the feature to enable
      - `options` object: Optional configuration options for the feature

## Response `200`

The message was received successfully

- object
  - `id` string, required: The ID of the created message
  - `text` string, required: The text of the message received
  - `usage` Usage, required: Usage information
    - `token` number, required: The tokens used in this exchange

## 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)