Delete an annotation

DELETE

/timeline/annotations/{id}

curl --request DELETE \
  --url https://example.com/api/v1/timeline/annotations/1

• API v1

Author-gated (403 for non-authors unless in AUTH-bypass mode).

Parameters

Path Parameters

id

required

integer

Responses

200

Deleted

Media typeapplication/json

object

deleted

required

boolean

Example^generated

{
  "deleted": true
}

400

Invalid id

Media typeapplication/json

object

error

required

Error message

string

Example^generated

{
  "error": "example"
}

401

Authentication required

Media typeapplication/json

object

error

required

Error message

string

Example^generated

{
  "error": "example"
}

403

Not the author

Media typeapplication/json

object

error

required

Error message

string

Example^generated

{
  "error": "example"
}

404

Annotation not found

Media typeapplication/json

object

error

required

Error message

string

Example^generated

{
  "error": "example"
}

500

Failed to delete annotation

Media typeapplication/json

object

error

required

Error message

string

Example^generated

{
  "error": "example"
}