InfoboardPostReadUsers

Introduction

InfoboardPostReadUsers record an explicit read confirmation by a User for an InfoboardPost. Each record belongs to one user and one post and cannot be updated directly.

Model Definition

Relations

Key	Relation	Type	Relation Field(s)
user	User	Belongs to	user_id
post	InfoboardPost	Belongs to	post_id

List by Post

List visible InfoboardPostReadUsers for one InfoboardPost.

Definition

GET /api/infoboard/posts/{infoboardPost}/read-users

Route Parameters

Parameter	Type	Description
infoboardPost	integer | string	InfoboardPost ID or hash.

Behavior

• The parent post must be visible to the authenticated user.

• Internal intratool users are excluded.

• Without permission to see all post read users, records are limited to users from departments accessible to the authenticated user.

Example Request

PHP

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

Example Response

[
  {
    "id": 1,
    "user_id": 4,
    "post_id": 1,
    "created_at": "2026-08-06 10:20:00"
  },
  {
    "id": 2,
    "user_id": 5,
    "post_id": 1,
    "created_at": "2026-08-06 10:25:00"
  }
]

Create

Record an explicit read confirmation by the authenticated user for an InfoboardPost.

Definition

POST /api/infoboard/posts/{infoboardPost}/read-users

Route Parameters

Parameter	Type	Description
infoboardPost	integer | string	InfoboardPost ID or hash.

Behavior

• post_id is derived from the route and user_id from the authenticated user. The request body is discarded.

• Group accounts cannot create read confirmations.

• The operation is idempotent for the same user and post and returns the existing record on repeated requests.

• A matching InfoboardPostSeenUser is created first when missing, and matching post notifications are marked as seen and read.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/infoboard/posts/1/read-users', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 1,
    "user_id": 4,
    "post_id": 1,
    "created_at": "2026-08-06 10:20:00"
  }
}