List conversations

curl -G https://api.moveworks.ai/export/v1/records/conversations \
     -H "Authorization: <apiKey>" \
     --data-urlencode "$filter=user_id eq '123456'" \
     --data-urlencode $select=id,created_time \
     --data-urlencode "$orderby=user_id desc" \
     -d $top=10 \
     -d $skip=10 \
     -d $count=true

{
  "@odata.context": "https://api.moveworks.ai/export/v1/records/$metadata#conversations",
  "@odata.nextLink": "https://api.moveworks.ai/export/v1/records/conversations?$skiptoken=abcdefghijklmno",
  "value": [
    {
      "id": "OqVm7dSD4uxD",
      "primary_domain": "IT",
      "route": "Notification",
      "user_id": "11793429900163968620",
      "last_updated_time": "2025-12-18T03:43:02.908Z",
      "created_time": "2025-12-17T07:25:17.202Z",
      "type": "CONVERSATION_TYPE_COMMS_NOTIFICATION",
      "detail": {
        "campaign_id": "86ccdb47-dde0-45c8-abca-858c8df9889e",
        "campaign_name": "Data API announcement"
      }
    }
  ]
}

Retrieve all conversations occurring with the Moveworks AI Assistant.

Authentication

Authorizationstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

$filterstringOptional

This option allows the client to filter the resource that is address by request URL

$selectstringOptional

This option allow the client to request a limited set of properties of an entity

$orderbystringOptional

This option allow the client to request resources in either ascending or descending order

$topintegerOptional

This option request the number of items to be included in the result

$skipintegerOptional

This query option requests the number of items in the queried collection that are to be skipped and not included in the result.

$countbooleanOptional

This option allows clients to request a count of the matching resources included with the resources in the result

Response

Successfully retrieved list of conversations

@odata.contextstring

URL to the metadata of the response.

@odata.nextLinkstring

URL to fetch the next set of results.

valuelist of objects

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error