ChatConversationEvents

Introduction

ChatConversationEvents record changes to a ChatConversation. Each event has a concrete type that defines the shape of its data field.

Model Definition

Relations

Key	Relation	Type	Relation Field(s)
user	User	Belongs to	user_id
chatConversation	ChatConversation	Belongs to	chat_conversation_id

Types

Type	data shape
created	Empty object.
updated	old and new objects containing changed fields.
deleted	Empty object.
titleChanged	old and new title values.
lockedAtChanged	old and new datetime or null values.
departmentAdded	targetable_type is department; targetable_id is the integer Department ID.
departmentRemoved	targetable_type is department; targetable_id is the integer Department ID.
userAdded	targetable_type is user; targetable_id is the integer User ID.
userLeft	targetable_type is user; targetable_id is the integer User ID.
userRemoved	targetable_type is user; targetable_id is the integer User ID.

Changing a conversation title or locked_at creates an updated event in addition to the corresponding titleChanged or lockedAtChanged event.

List by conversation

List ChatConversationEvents for a ChatConversation.

Definition

GET /api/chat/conversations/{chatConversation}/events

Route Parameters

Parameter	Type	Description
chatConversation	integer | string	ChatConversation ID or hash.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/chat/conversations/1/events', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

[
  {
    "id": 1,
    "user_id": 3,
    "chat_conversation_id": 1,
    "type": "titleChanged",
    "data": {
      "old": "Launch",
      "new": "Project launch"
    },
    "created_at": "2026-08-06 09:32:00",
    "updated_at": "2026-08-06 09:32:00"
  },
  {
    "id": 2,
    "user_id": 4,
    "chat_conversation_id": 1,
    "type": "lockedAtChanged",
    "data": {
      "old": null,
      "new": "2026-08-06 10:00:00"
    },
    "created_at": "2026-08-06 09:34:00",
    "updated_at": "2026-08-06 09:34:00"
  }
]

Show

Show one ChatConversationEvent.

Definition

GET /api/chat/conversations/events/{chatConversationEvent}

Route Parameters

Parameter	Type	Description
chatConversationEvent	integer	ChatConversationEvent ID.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/chat/conversations/events/1', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "id": 1,
  "user_id": 3,
  "chat_conversation_id": 1,
  "type": "titleChanged",
  "data": {
    "old": "Launch",
    "new": "Project launch"
  },
  "created_at": "2026-08-06 09:32:00",
  "updated_at": "2026-08-06 09:32:00"
}