For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DeveloperAcademyCommunityStatus
    • Overview
    • API Credentials
    • Errors
    • Legacy & Deprecated APIs
  • Events API
    • Chat Markup
    • Rate Limits
    • Message Delivery
  • (Beta) Conversations API
  • Data API
    • GETList conversations
    • GETList interactions
    • GETList plugins calls
    • GETList Plugin Resources
    • GETList Users
  • Webhook Listeners
  • Content Gateway
    • Overview
    • Integration Strategies
    • Starter Code
    • Verifying Your Build
    • Connecting Your Gateway to Moveworks
    • Authentication
    • How Permissions Work
    • Common Pitfalls
    • Operational Guide
    • Errors
    • Supported MIME Types
  • Legacy Gateways
    • Authentication
    • Response Options
    • Field Types
    • Form Gateway Errors
DeveloperAcademyCommunityStatus
Data API

List conversations

||View as Markdown|
GET
/conversations
GET
/export/v1/records/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
1{
2  "@odata.context": "https://api.moveworks.ai/export/v1/records/$metadata#conversations",
3  "@odata.nextLink": "https://api.moveworks.ai/export/v1/records/conversations?$skiptoken=abcdefghijklmno",
4  "value": [
5    {
6      "id": "OqVm7dSD4uxD",
7      "primary_domain": "IT",
8      "route": "Notification",
9      "user_id": "11793429900163968620",
10      "last_updated_time": "2025-12-18T03:43:02.908Z",
11      "created_time": "2025-12-17T07:25:17.202Z",
12      "type": "CONVERSATION_TYPE_COMMS_NOTIFICATION",
13      "detail": {
14        "type": "RESOURCE_TYPE_TICKET",
15        "source": "ServiceNow",
16        "domain": "IT",
17        "usecase_id": "f1c3a4b2-1d2e-4a3b-9c8d-5e6f7a8b9c0d",
18        "usecase_name": "New Hire Onboarding",
19        "ticket_id": "INC0012345",
20        "campaign_id": "86ccdb47-dde0-45c8-abca-858c8df9889e",
21        "campaign_name": "Data API announcement",
22        "channel_id": "C01ABCD2EFG",
23        "channel_name": "it-help",
24        "content": "I can't log in to Okta"
25      }
26    }
27  ]
28}
Retrieve all conversations occurring with the Moveworks AI Assistant.
Was this page helpful?
Previous

List interactions

Next
Built with

Authentication

Authorizationstring
API Key authentication via header
OR
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