ManualEntrySeenUsers

Introduction

ManualEntrySeenUsers record when a User views a ManualEntry. A user has at most one effective seen record per entry because the create endpoint is idempotent.

Model Definition

Relations

Key	Relation	Type	Relation Field(s)
user	User	Belongs to	user_id
manualEntry	ManualEntry	Belongs to	manual_entry_id

List by ManualEntry

List ManualEntrySeenUsers visible for a ManualEntry.

Definition

GET /api/manual/entries/{manualEntry}/seen-users

Route Parameters

Parameter	Type	Description
manualEntry	integer | string	ManualEntry ID, hash, or slug.

Behavior

• The user must be able to show the parent entry.

• intratool accounts are excluded. Without the permission to see all entry seen users, the result is limited to users in allowed departments.

Example Request

PHP

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

Example Response

[
  {
    "id": 1,
    "user_id": 3,
    "manual_entry_id": 1,
    "created_at": "2026-08-06 09:30:00"
  },
  {
    "id": 2,
    "user_id": 4,
    "manual_entry_id": 1,
    "created_at": "2026-08-06 09:35:00"
  }
]

Mark as Seen

Mark a ManualEntry as seen by the current authenticated User.

Definition

POST /api/manual/entries/{manualEntry}/seen-users

Route Parameters

Parameter	Type	Description
manualEntry	integer | string	ManualEntry ID, hash, or slug.

Behavior

• user_id comes from authentication and manual_entry_id comes from the route; request-body values are ignored.

• Repeated requests return the existing record instead of creating duplicates.

• Creating the record marks notifications for the entry as read, which also marks those notifications as seen.

Example Request

PHP

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

Example Response

{
  "status": "success",
  "data": {
    "id": 1,
    "user_id": 3,
    "manual_entry_id": 1,
    "created_at": "2026-08-06 09:30:00"
  }
}