Update (Beta) — DevRev

Updates the requested conversation.

Request

This endpoint expects an object.

idstringRequired

The ID of the conversation to update.

applies_to_partsobjectOptional

custom_fieldsmap from strings to anyOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Requested custom schemas described abstractly. Every provided schema’s custom field must be specified, otherwise a bad request error is returned. If a new custom schema specifier is provided, then it will be added to the work, otherwise if a custom schema is omitted from the specifier, it remains unmodified.

descriptionstringOptional

The updated description for the conversation.

groupstringOptional

The group that the conversation is associated with.

is_spambooleanOptional

Whether the conversation is spam.

metadataobjectOptional

owned_byobjectOptional

stageobjectOptional

Updates an object’s stage.

statusstringOptional

The updated status of the conversation.

tagsobjectOptional

titlestringOptional

The updated title of the conversation.

user_sessionsobjectOptional

Response

This endpoint returns an object.

conversationobject

1 curl -X POST https://api.devrev.ai/conversations.update \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "id": "id" 6 }'

1 { 2 "conversation": { 3 "id": "id", 4 "members": [ 5 { 6 "type": "sys_user", 7 "id": "members" 8 } 9 ], 10 "created_by": { 11 "type": "sys_user", 12 "id": "created_by", 13 "display_id": "created_by", 14 "display_name": "created_by", 15 "display_picture": { 16 "id": "id" 17 }, 18 "email": "created_by", 19 "full_name": "created_by", 20 "state": "active" 21 }, 22 "created_date": "2023-01-01T12:00:00Z", 23 "description": "description", 24 "display_id": "display_id", 25 "group": { 26 "id": "id", 27 "display_id": "display_id", 28 "member_type": "dev_user", 29 "name": "name" 30 }, 31 "messages": [ 32 { 33 "type": "timeline_comment", 34 "id": "messages", 35 "object": "messages", 36 "object_display_id": "messages", 37 "created_date": "2023-01-01T12:00:00Z", 38 "modified_date": "2023-01-01T12:00:00Z" 39 } 40 ], 41 "metadata": { 42 "url_context": "url_context" 43 }, 44 "modified_by": { 45 "type": "sys_user", 46 "id": "modified_by", 47 "display_id": "modified_by", 48 "display_name": "modified_by", 49 "display_picture": { 50 "id": "id" 51 }, 52 "email": "modified_by", 53 "full_name": "modified_by", 54 "state": "active" 55 }, 56 "modified_date": "2023-01-01T12:00:00Z", 57 "owned_by": [ 58 { 59 "type": "sys_user", 60 "id": "owned_by" 61 } 62 ], 63 "sla_tracker": { 64 "id": "id", 65 "display_id": "display_id" 66 }, 67 "stage": { 68 "name": "name", 69 "notes": "notes", 70 "ordinal": 1, 71 "stage": { 72 "id": "id" 73 }, 74 "state": { 75 "id": "id" 76 } 77 }, 78 "tags": [ 79 { 80 "tag": { 81 "id": "id", 82 "name": "name" 83 } 84 } 85 ], 86 "title": "title" 87 } 88 }

1	curl -X POST https://api.devrev.ai/conversations.update \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"id": "id"
6	}'

1	{
2	"conversation": {
3	"id": "id",
4	"members": [
5	{
6	"type": "sys_user",
7	"id": "members"
8	}
9	],
10	"created_by": {
11	"type": "sys_user",
12	"id": "created_by",
13	"display_id": "created_by",
14	"display_name": "created_by",
15	"display_picture": {
16	"id": "id"
17	},
18	"email": "created_by",
19	"full_name": "created_by",
20	"state": "active"
21	},
22	"created_date": "2023-01-01T12:00:00Z",
23	"description": "description",
24	"display_id": "display_id",
25	"group": {
26	"id": "id",
27	"display_id": "display_id",
28	"member_type": "dev_user",
29	"name": "name"
30	},
31	"messages": [
32	{
33	"type": "timeline_comment",
34	"id": "messages",
35	"object": "messages",
36	"object_display_id": "messages",
37	"created_date": "2023-01-01T12:00:00Z",
38	"modified_date": "2023-01-01T12:00:00Z"
39	}
40	],
41	"metadata": {
42	"url_context": "url_context"
43	},
44	"modified_by": {
45	"type": "sys_user",
46	"id": "modified_by",
47	"display_id": "modified_by",
48	"display_name": "modified_by",
49	"display_picture": {
50	"id": "id"
51	},
52	"email": "modified_by",
53	"full_name": "modified_by",
54	"state": "active"
55	},
56	"modified_date": "2023-01-01T12:00:00Z",
57	"owned_by": [
58	{
59	"type": "sys_user",
60	"id": "owned_by"
61	}
62	],
63	"sla_tracker": {
64	"id": "id",
65	"display_id": "display_id"
66	},
67	"stage": {
68	"name": "name",
69	"notes": "notes",
70	"ordinal": 1,
71	"stage": {
72	"id": "id"
73	},
74	"state": {
75	"id": "id"
76	}
77	},
78	"tags": [
79	{
80	"tag": {
81	"id": "id",
82	"name": "name"
83	}
84	}
85	],
86	"title": "title"
87	}
88	}