Skip to main content
A Thread in Monsteria represents a conversation that is ongoing between a user and an Agent. Threads group related Activities, Events, and Attachments together. A Thread is considered active as long as the conversation is within the data retention period and the doNotProcess flag is not set by an EventConfig or manually via the API. You can query and manage Threads via the API.

​
Attributes

Each Thread has the following attributes:
  • id: string - Unique identifier for the Thread
  • orgId: string - The organization ID the Thread belongs to
  • agentId: string - The agent associated with the Thread
  • channelType: string - The type of channel (e.g., email, chat)
  • channelProvider: string - The provider of the channel (e.g., GMAIL, OUTLOOK)
  • externalReferenceId: string - The external system’s identifier for the Thread (e.g., Gmail thread ID)
  • createdAt: Date - Timestamp when the Thread was created
  • updatedAt: Date - Timestamp when the Thread was last updated
  • activities: Activity[] - List of Activities in the Thread
  • events: Event[] - List of Events in the Thread

​
Example

{
  "id": "2786a46d-1971-401b-a4d5-7f037d970a02",
  "orgId": "87daa17c-ecd2-4dd0-a626-feca90b64d4f",
  "agentId": "5167d917-afa4-4988-876a-e1fda071e52c",
  "channelProvider": "GMAIL",
  "externalReferenceId": "gmail-thread-id",
  "createdAt": "2025-10-07T12:34:56.789Z",
  "updatedAt": "2025-10-07T12:34:56.789Z",
  "activities": [
    {
      "id": "cdc9c789-f489-44f8-94dc-4c6b246a6b40",
      "agentId": "eaeae4eb-1438-425d-a984-c3c6d764dd29",
      "channelProvider": "GMAIL",
      "threadId": "9dd51fe2-48ae-42d0-91db-0123ea3423b5",
      "direction": "INBOUND",
      "externalReferenceId": "gmail-message-id",
      "scheduledAt": "2023-11-07T05:31:56Z",
      "transcript": "From: John Doe [[email protected]]\nSent At: 2023-11-07T05:31:56Z\nTo: [email protected]\nCC: [email protected]\nBCC: [email protected]\nSubject: Meeting Request\n\nHi there, I would like to schedule an appointment for my annual exam.",
      "status": "COMPLETED",
      "metadata": {},
      "fromName": "John Doe",
      "from": "[email protected]",
      "to": ["[email protected]"],
      "cc": ["[email protected]"],
      "bcc": ["[email protected]"],
      "subject": "Annual exam",
      "body": "Hi there, I would like to schedule an appointment for my annual exam.",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "events": [
    {
      "id": "926d728c-b186-4905-9f7b-dd0f4ef15f51",
      "eventConfigId": "ac03a02a-5d36-4489-826c-efa9bf6a96a1",
      "extractedData": {
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumber": "+1234567890",
        "preferredDateTime": "2025-10-10T14:30:00Z"
      },
      "activityId": "80854328-d7ee-49e2-92b4-cfc36a61aa08",
      "threadId": "91014f61-74d8-4f14-a227-19d08d8a966f",
      "createdAt": "2025-10-07T12:34:56.789Z",
      "updatedAt": "2025-10-07T12:34:56.789Z"
    }
  ]
}