List annotations for one event
GET
/timeline/annotations
const url = 'https://example.com/api/v1/timeline/annotations?source=sync&eventId=1';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/api/v1/timeline/annotations?source=sync&eventId=1'Returns every annotation attached to a single timeline event (a thread), oldest first.
Orphaned annotations (whose source event no longer exists) remain reachable here by explicit
source+eventId but never surface in the merged feed.
Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”source
required
The event source a timeline event originates from.
string
eventId
required
integer
Responses
Section titled “Responses”Annotation thread for the event
Media typeapplication/json
Array<object>
A user note attached to a single timeline event.
object
id
required
integer
source
required
The event source a timeline event originates from.
string
eventId
required
integer
body
required
string
authorUserId
required
integer
authorName
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
Example
[ { "source": "sync" }]Missing or invalid source/eventId
Media typeapplication/json
object
error
required
Error message
string
Examplegenerated
{ "error": "example"}Failed to list annotations
Media typeapplication/json
object
error
required
Error message
string
Examplegenerated
{ "error": "example"}