delete__systemevent_read

DELETE /systemevent/read

Mark System Event(s) as Unread

Marks one or more system events as unread for the current authenticated user by removing the read records. Send a single id or an array ids in the request body. Used to allow users to “mark as unread” in notification UIs. The operation is idempotent: deleting an already-unread event still returns success.

Key Features:

• Removes server-side read state for the current user and the given event(s)

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

• Idempotent: calling again when the event is already unread still returns success

• Used by notification UIs to support “Mark as unread”

Authentication:

• Requires valid Bearer token authentication

• User can only remove their own read state (no cross-user scope)

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 markSystemEventAsUnread = async (systemEventLogId: number | number[]): Promise<SystemEventReadStatusResponse> => {
  const body = Array.isArray(systemEventLogId) ? { ids: systemEventLogId } : { id: systemEventLogId };
  return this.makeRequest<SystemEventReadStatusResponse>('systemevent/read', 'DELETE', body);
};

Code Samples

Shell

# Mark one system event as unread
curl -X DELETE 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 unread
curl -X DELETE 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

DELETE 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: 'DELETE',
  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.delete '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.delete('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('DELETE', '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("DELETE");
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("DELETE", "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 unread (use id or ids)
ids	body	number[]	false	Array of system event log IDs to mark as unread (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"
}

500 Response

{
  "error": "Internal server error"
}

Responses

Status	Meaning	Description	Schema
200	OK	Event(s) marked as unread successfully	Inline
400	Bad Request	Missing or invalid id or ids	Inline
401	Unauthorized	Authentication required or user not found	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, 500

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

This operation requires authentication via Bearer token.