post__systemevent_read

POST /systemevent/read

Mark System Event(s) as Read

Marks one or more system events as read for the current authenticated user. Send a single id or an array ids in the request body. Used to track which notifications the user has seen. Events must belong to the same organization as the user; events in other orgs are ignored.

Key Features:

• Persists read state per user and per event (server-side)

• Supports a single event id or multiple ids in one request

• Idempotent: calling again for an already-read event still returns success

• Used by notification UIs (e.g. bell icon) to clear unread state

Authentication:

• Requires valid Bearer token authentication

• User must be associated with an organization

• Only events in the user’s organization are marked as read; others are skipped

Request Body: JSON with either id (number) or ids (array of numbers). At least one valid integer id is required.

TypeScript Client Library

// Single id or array of ids
public markSystemEventAsRead = async (systemEventLogId: number | number[]): Promise<SystemEventReadStatusResponse> => {
  const body = Array.isArray(systemEventLogId) ? { ids: systemEventLogId } : { id: systemEventLogId };
  return this.makeRequest<SystemEventReadStatusResponse>('systemevent/read', 'POST', body);
};

Code Samples

Shell

# Mark one system event as read
curl -X POST https://backend.flashback.tech/systemevent/read \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-jwt-token' \
  -d '{"id": 12345}'

# Mark multiple events as read
curl -X POST https://backend.flashback.tech/systemevent/read \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-jwt-token' \
  -d '{"ids": [12345, 12346, 12347]}'

HTTP

POST https://backend.flashback.tech/systemevent/read HTTP/1.1
Host: backend.flashback.tech
Accept: application/json
Content-Type: application/json
Authorization: Bearer your-jwt-token

{"id": 12345}

JavaScript

const headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer your-jwt-token'
};

fetch('https://backend.flashback.tech/systemevent/read', {
  method: 'POST',
  headers: headers,
  body: JSON.stringify({ id: 12345 })
})
.then(function(res) { return res.json(); })
.then(function(body) { console.log(body); });

Ruby

require 'rest-client'

headers = {
  'Accept' => 'application/json',
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer your-jwt-token'
}

result = RestClient.post 'https://backend.flashback.tech/systemevent/read',
  { id: 12345 }.to_json, headers: headers

p JSON.parse(result)

Python

import requests

headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer your-jwt-token'
}

r = requests.post('https://backend.flashback.tech/systemevent/read',
                  headers=headers, json={'id': 12345})
print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
    'Authorization' => 'Bearer your-jwt-token',
);

$client = new \GuzzleHttp\Client();

try {
    $response = $client->request('POST', 'https://backend.flashback.tech/systemevent/read', array(
        'headers' => $headers,
        'json' => array('id' => 12345),
    ));
    print_r($response->getBody()->getContents());
} catch (\GuzzleHttp\Exception\BadResponseException $e) {
    print_r($e->getMessage());
}

Java

URL obj = new URL("https://backend.flashback.tech/systemevent/read");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Accept", "application/json");
con.setRequestProperty("Content-Type", "application/json");
con.setRequestProperty("Authorization", "Bearer your-jwt-token");
con.setDoOutput(true);
con.getOutputStream().write("{\"id\":12345}".getBytes());

int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
    "bytes"
    "net/http"
)

func main() {
    headers := map[string][]string{
        "Accept":       []string{"application/json"},
        "Content-Type": []string{"application/json"},
        "Authorization": []string{"Bearer your-jwt-token"},
    }
    body := []byte(`{"id":12345}`)
    req, err := http.NewRequest("POST", "https://backend.flashback.tech/systemevent/read", bytes.NewReader(body))
    if err != nil { return }
    for k, v := range headers { req.Header[k] = v }

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Parameters

Name	In	Type	Required	Description
id	body	number	false	Single system event log ID to mark as read (use id or ids)
ids	body	number[]	false	Array of system event log IDs to mark as read (use id or ids)

Provide either id or ids; at least one valid integer id is required.

Example responses

200 Response

{
  "success": true
}

400 Response

{
  "error": "Missing or invalid id or ids"
}

401 Response

{
  "error": "Unauthorized"
}

403 Response

{
  "error": "User not associated with an organization"
}

500 Response

{
  "error": "Internal server error"
}

Responses

Status	Meaning	Description	Schema
200	OK	Event(s) marked as read successfully	Inline
400	Bad Request	Missing or invalid id or ids	Inline
401	Unauthorized	Authentication required or user not found	Inline
403	Forbidden	User not associated with an organization	Inline
500	Internal Server Error	Internal server error	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	true	none	Whether the operation succeeded

Status Code 400, 401, 403, 500

Name	Type	Required	Restrictions	Description
» error	string	true	none	Error message

This operation requires authentication via Bearer token. Only events in the user’s organization are marked as read; other ids are ignored.