Reactions

Introduction

Reactions let a User attach one emoji value to a resource with the Reactions capability. Posting again for the same user and resource updates that record.

Model Definition

Reactable Types

• chatMessage - Attaches the Reaction to a ChatMessage.

• infoboardComment - Attaches the Reaction to an InfoboardComment.

• infoboardPost - Attaches the Reaction to an InfoboardPost.

• manualEntry - Attaches the Reaction to a ManualEntry.

Capabilities

• Notifications - Creating or changing a reaction can trigger notifications according to the target resource and notification settings.

Relations

Key	Relation	Type	Relation Field(s)
user	User	Belongs to	user_id
reactable	Reactable resource	Morph to	reactable_type, reactable_id

Reactable resources can return reactions_summary as an append. It contains emoji/count pairs sorted by descending count.

List by Reactable

List Reactions for one reactable entity.

Definition

GET /api/reactions/{reactableType}/{reactableId}

Route Parameters

Parameter	Type	Description
reactableType	string	Selects one of the supported Reactable Types.
reactableId	integer	Existing reactable ID.

Request Keys

Key	Type	Default	Description
selects	string	All fields	Comma-separated fields to return.
relations	string	Default relations	Pipe-separated relations to include.

Example Request

PHP

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

Example Response

[
  {
    "id": 61,
    "user_id": 7,
    "reactable_id": 850,
    "reactable_type": "infoboardPost",
    "value": "👍",
    "created_at": "2026-08-06 09:00:00",
    "updated_at": "2026-08-06 09:00:00",
    "deleted_at": null
  },
  {
    "id": 62,
    "user_id": 19,
    "reactable_id": 850,
    "reactable_type": "infoboardPost",
    "value": "🎉",
    "created_at": "2026-08-06 09:05:00",
    "updated_at": "2026-08-06 09:10:00",
    "deleted_at": null
  }
]

Summary by Reactable

Summarize Reactions for one reactable entity.

Definition

GET /api/reactions/{reactableType}/{reactableId}/summary

Route Parameters

Parameter	Type	Description
reactableType	string	Selects one of the supported Reactable Types.
reactableId	integer	Existing reactable ID.

Example Request

PHP

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

Example Response

[
  {
    "reaction": "👍",
    "count": 3
  },
  {
    "reaction": "🎉",
    "count": 1
  }
]

Show

Show one Reaction.

Definition

GET /api/reactions/{reaction}

Route Parameters

Parameter	Type	Description
reaction	integer	Reaction ID.

Request Keys

Key	Type	Default	Description
selects	string	All fields	Comma-separated fields to return.
relations	string	Default relations	Pipe-separated relations to include.

Example Request

PHP

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

Example Response

{
  "id": 61,
  "user_id": 7,
  "reactable_id": 850,
  "reactable_type": "infoboardPost",
  "value": "👍",
  "created_at": "2026-08-06 09:00:00",
  "updated_at": "2026-08-06 09:00:00",
  "deleted_at": null
}

Create or Update

Create or update the current user's Reaction for one reactable entity.

Definition

POST /api/reactions

Request Keys

Key	Type	Default	Description
reactable_type*	string	-	Selects one of the supported Reactable Types.
reactable_id*	integer	-	Existing reactable ID.
value*	string	-	Emoji value, at most 10 characters.

Keys with * are required.

Behavior

user_id is always taken from the authenticated user. The complete request combination determines whether the response is a newly created reaction or the updated existing reaction.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/reactions', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'reactable_type' => 'infoboardPost',
        'reactable_id' => 850,
        'value' => '🎉'
    ]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 63,
    "user_id": 7,
    "reactable_id": 850,
    "reactable_type": "infoboardPost",
    "value": "🎉",
    "created_at": "2026-08-06 10:00:00",
    "updated_at": "2026-08-06 10:00:00",
    "deleted_at": null
  }
}

Delete

Delete an existing Reaction.

Definition

DELETE /api/reactions/{reaction}

Route Parameters

Parameter	Type	Description
reaction	integer	Reaction ID.

Example Request

PHP

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

Example Response

{
  "status": "success",
  "data": null
}