Skip to main content
PATCH
/
api
/
v2
/
mentions
/
{sourceId}
Update a mention
curl --request PATCH \
  --url https://app.octolens.com/api/v2/mentions/{sourceId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "postId": 0,
  "timestamp": "2026-05-06 13:35:37.000"
}
'
{
  "ok": true
}

Authorizations

​
Authorization
string
header
required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.

Path Parameters

​
sourceId
string
required

Body

application/json

Mutation request for a mention. The action field discriminates which update to apply.

​
action
string
required

Toggle the engaged-with flag on the mention.

Allowed value: "engage"
​
postId
integer
required

Internal post id.

Required range: -9007199254740991 <= x <= 9007199254740991
​
timestamp
string
required

The mention's timestamp, copied verbatim from the list/export response. Tinybird-style format (YYYY-MM-DD HH:mm:ss.SSS, UTC, no Z suffix); ISO 8601 also accepted. Used together with sourceId / postId to uniquely key the mention.

Pattern: ^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}:\d{2}(\.\d{1,9})?(Z|[+-]\d{2}:?\d{2})?$
Example:

"2026-05-06 13:35:37.000"

Response

200 response

​
ok
boolean
required