Create Conversation

POST /conversations

Create new conversation

application/json

Body

To use focus mode, add a list of document IDs to limit bot's knowledge base for this conversation.

name string Required
bot_id string Required
document_ids array[string]

Only documents that exist in the folders the bot has access to are allowed. You can give bot access to all folders if you wish to limit documents from your whole knowledge base.

Not more than 1000 elements.

Responses

200 application/json

OK
Hide response attribute Show response attribute object
- data object
  
  Hide data attributes Show data attributes object
  
  id string
  
  name string Required
  
  bot_id string Required
  
  created_at integer(int64)
  
  Unix timestamp in seconds
422 application/json

Request validation failure.
Hide response attributes Show response attributes object
- message string
- errors object
  
  Hide errors attribute Show errors attribute object
  
  bot_id array[string]

POST /conversations

curl \
 -X POST https://getcody.ai/api/v1/conversations \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"name":"string","bot_id":"string","document_ids":["string"]}'

Request example

{
  "name": "string",
  "bot_id": "string",
  "document_ids": [
    "string"
  ]
}

Response examples (200)

{
  "data": {
    "id": "string",
    "name": "string",
    "bot_id": "string",
    "created_at": 42
  }
}

Response examples (422)

{
  "message": "The selected bot id is invalid.",
  "errors": {
    "bot_id": [
      "The selected bot id is invalid."
    ]
  }
}