conversations

Export

GET
Exports a collection of conversation items.

Query parameters

applies_to_partsstringOptional
Filters for conversations belonging to any of the provided parts.
firstintegerOptional
The number of conversation items to return. The default is '50', the maximum is '5000'.
groupstringOptional
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.
membersstringOptional
Filters for conversations where these users are participants.
owned_bystringOptional
Filters for conversations owned by any of these users.
rev_orgstringOptional
Filters for conversations that are associated with any of the provided Rev organizations.
sla_summary.stageenumOptional
Filters for records with any of the provided SLA stages.
Allowed values: breachedcompletedpausedrunningwarning
source_channelsstringOptional
Filters for conversations with any of the provided source channels.
stage.namestringOptional
Filters for records in the provided stage(s) by name.
tagsstringOptional
Filters for conversations with any of the provided tags.
tags_v2.idstringOptional
The ID of the tag.
tags_v2.valuestringOptional
The value for the object's association with the tag. If specified, the value must be one that's specified in the tag's allowed values.

Response

This endpoint returns an object
conversations
list of objects
The resulting collection of conversation items.
GET
1curl -G https://api.devrev.ai/conversations.export \
2 -H "Authorization: <apiKey>" \
3 -d tags_v2.id=TAG-12345
200Retrieved
1{
2 "conversations": [
3 {
4 "id": "id",
5 "members": [],
6 "created_date": "2023-01-01T12:00:00Z",
7 "description": "description",
8 "display_id": "display_id",
9 "group": {
10 "id": "id"
11 },
12 "modified_date": "2023-01-01T12:00:00Z",
13 "sla_tracker": {
14 "id": "id"
15 },
16 "stage": {
17 "name": "name"
18 },
19 "tags": [
20 {
21 "tag": {
22 "id": "id",
23 "name": "name"
24 }
25 }
26 ],
27 "title": "title"
28 }
29 ]
30}