List Conversations (POST)

POST

Lists the available conversations.

Request

This endpoint expects an object.

applies_to_partslist of stringsOptional

Filters for conversations belonging to any of the provided parts.

cursorstringOptional

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

custom_fieldsmap from strings to anyOptional

Filters for custom fields.

grouplist of stringsOptional

Filters for conversation that belong to the given groups.

is_creator_verifiedbooleanOptional

Filters for conversations that are created by verified users.

is_spambooleanOptional

Filters for conversations that are spam.

limitintegerOptional

The maximum number of conversations to return. The default is ‘50’.

memberslist of stringsOptional

Filters for conversations where these users are participants.

modeenumOptional

Allowed values: afterbefore

The iteration mode to use. If “after”, then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If “before”, then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.

modified_dateobjectOptional

owned_bylist of stringsOptional

Filters for conversations owned by any of these users.

rev_orgslist of stringsOptional

Filters for conversations that are associated with any of the provided Rev organizations.

sla_summaryobjectOptional

The filter for SLA summary.

source_channellist of stringsOptional

Filters for conversations with any of the provided source channels.

stageobjectOptional

The filter for stages.

subtypelist of stringsOptional

Filters for conversation with any of the provided subtypes.

tags_v2list of objectsOptional

Filters for conversations with any of the provided tags with value.

rev_orglist of stringsOptionalDeprecated

Filters for conversations that are associated with any of the provided Rev organizations.

source_channelslist of stringsOptionalDeprecated

Filters for conversations with any of the provided source channels.

tagslist of stringsOptionalDeprecated

Filters for conversations with any of the provided tags.

Response

The response to listing the conversations.

conversationslist of objects

The list of conversations.

next_cursorstringOptional

The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.

prev_cursorstringOptional

The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.

POST

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

200Successful

1 {
2   "conversations": [
3     {
4       "id": "id",
5       "members": [
6         {
7           "type": "sys_user",
8           "id": "members"
9         }
10       ],
11       "created_by": {
12         "type": "sys_user",
13         "id": "created_by"
14       },
15       "created_date": "2023-01-01T12:00:00Z",
16       "custom_fields": {
17         "key": "value"
18       },
19       "custom_schema_fragments": [
20         "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id"
21       ],
22       "description": "description",
23       "display_id": "display_id",
24       "group": {
25         "id": "id"
26       },
27       "messages": [
28         {
29           "type": "timeline_comment",
30           "id": "messages",
31           "object": "messages",
32           "object_display_id": "messages",
33           "created_date": "2023-01-01T12:00:00Z",
34           "modified_date": "2023-01-01T12:00:00Z"
35         }
36       ],
37       "modified_by": {
38         "type": "sys_user",
39         "id": "modified_by"
40       },
41       "modified_date": "2023-01-01T12:00:00Z",
42       "owned_by": [
43         {
44           "type": "sys_user",
45           "id": "owned_by"
46         }
47       ],
48       "sla_summary": {
49         "target_time": "2023-01-01T12:00:00Z"
50       },
51       "sla_tracker": {
52         "id": "id"
53       },
54       "stage": {
55         "name": "name"
56       },
57       "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
58       "subtype": "subtype",
59       "tags": [
60         {
61           "tag": {
62             "id": "id",
63             "name": "name"
64           }
65         }
66       ],
67       "title": "title"
68     }
69   ],
70   "next_cursor": "next_cursor",
71   "prev_cursor": "prev_cursor"
72 }

Update Conversation

Up Next

Built with

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

1	{
2	"conversations": [
3	{
4	"id": "id",
5	"members": [
6	{
7	"type": "sys_user",
8	"id": "members"
9	}
10	],
11	"created_by": {
12	"type": "sys_user",
13	"id": "created_by"
14	},
15	"created_date": "2023-01-01T12:00:00Z",
16	"custom_fields": {
17	"key": "value"
18	},
19	"custom_schema_fragments": [
20	"don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id"
21	],
22	"description": "description",
23	"display_id": "display_id",
24	"group": {
25	"id": "id"
26	},
27	"messages": [
28	{
29	"type": "timeline_comment",
30	"id": "messages",
31	"object": "messages",
32	"object_display_id": "messages",
33	"created_date": "2023-01-01T12:00:00Z",
34	"modified_date": "2023-01-01T12:00:00Z"
35	}
36	],
37	"modified_by": {
38	"type": "sys_user",
39	"id": "modified_by"
40	},
41	"modified_date": "2023-01-01T12:00:00Z",
42	"owned_by": [
43	{
44	"type": "sys_user",
45	"id": "owned_by"
46	}
47	],
48	"sla_summary": {
49	"target_time": "2023-01-01T12:00:00Z"
50	},
51	"sla_tracker": {
52	"id": "id"
53	},
54	"stage": {
55	"name": "name"
56	},
57	"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
58	"subtype": "subtype",
59	"tags": [
60	{
61	"tag": {
62	"id": "id",
63	"name": "name"
64	}
65	}
66	],
67	"title": "title"
68	}
69	],
70	"next_cursor": "next_cursor",
71	"prev_cursor": "prev_cursor"
72	}