Skip to main content
POST
/
api
/
v2
/
admin
/
announcements
/
{id}
/
read
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"

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

Documentation Index

Fetch the complete documentation index at: https://docs.urban-things.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 -X POST "https://api.example.com/api/v2/admin/announcements/1/read" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: your-tenant-id"

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

​
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