conversations

Create

POST
Creates a conversation.

Request

This endpoint expects an object.
type
"support"Required
description
stringOptional
Description for the conversation.
group
stringOptional
The group that the conversation is associated with.
is_spam
booleanOptional
Whether the conversation is spam.
members
list of stringsOptional
The users in the conversation.
messages
list of objectsOptional
Initial messages on the conversation.
metadata
objectOptional
source_channel
stringOptional
Whether the conversation is from a source channel.
stage
objectOptional
Sets an object's initial stage.
tags
list of objectsOptional
Tags associated with the conversation.
title
stringOptional
The title for the conversation.
user_sessions
list of stringsOptional
The IDs of user sessions associated with the conversation.

Response

This endpoint returns an object
conversation
object
POST
1curl -X POST https://api.devrev.ai/conversations.create \
2 -H "Authorization: <apiKey>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "type": "support"
6}'
200Successful
1{
2 "conversation": {
3 "id": "id",
4 "members": [],
5 "created_date": "2023-01-01T12:00:00Z",
6 "description": "description",
7 "display_id": "display_id",
8 "group": {
9 "id": "id",
10 "display_id": "display_id",
11 "name": "name"
12 },
13 "metadata": {
14 "url_context": "url_context"
15 },
16 "modified_date": "2023-01-01T12:00:00Z",
17 "sla_tracker": {
18 "id": "id",
19 "display_id": "display_id"
20 },
21 "stage": {
22 "name": "name"
23 },
24 "tags": [
25 {
26 "tag": {
27 "id": "id",
28 "name": "name"
29 }
30 }
31 ],
32 "title": "title"
33 }
34}