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

# 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]}'

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}

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); });

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)

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

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());
}

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());

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

Type

Required

Description

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

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.

Previouspost__systemevent_read NextDevice/Session Management

Last updated 22 days ago

Was this helpful?

hashtagTypeScript Client Library

hashtagCode Samples

hashtagParameters

hashtagExample responses

hashtagResponses

hashtagResponse Schema

TypeScript Client Library

Code Samples

Parameters

Example responses

Responses

Response Schema