Mark Announcement as Read

Mark a specific announcement as read by the current user

POST /api/v2/admin/announcements/{id}/read

cURL

curl -X POST "https://api.example.com/api/v2/admin/announcements/1/read" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: your-tenant-id"

const response = await fetch('/api/v2/admin/announcements/1/read', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Tenant-ID': 'your-tenant-id'
  }
});

const data = await response.json();

Success Response

{
  "success": true,
  "message": "Announcement marked as read"
}

{
  "success": false,
  "message": "Announcement not found"
}

Headers

Authorization · string · required

Bearer token for authentication

X-Tenant-ID · string · required

The tenant ID to scope the announcement

Path Parameters

id · integer · required

The unique identifier of the announcement to mark as read

Response

success · boolean

Indicates if the request was successful

message · string

Success message

cURL

curl -X POST "https://api.example.com/api/v2/admin/announcements/1/read" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: your-tenant-id"

const response = await fetch('/api/v2/admin/announcements/1/read', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Tenant-ID': 'your-tenant-id'
  }
});

const data = await response.json();

Success Response

{
  "success": true,
  "message": "Announcement marked as read"
}

{
  "success": false,
  "message": "Announcement not found"
}

Notes

• This endpoint creates or updates an announcement_reads record for the current user
• If the announcement is already marked as read, the operation is idempotent
• The read_at timestamp is set to the current time
• Only announcements belonging to the specified tenant can be marked as read