me

Post a new comment on a signal (with optional @-mentions)

All roles allowed. Self-mentions and non-member mentions are silently dropped. Server fires "mentioned" notifications to each valid mention and "commented_on_my_share" to the original sharer (suppressed if the sharer was already mentioned or is the commenter themselves).

post/api/me/signals/{id}/comments

Request

  • Base URL: https://api.signalraven.ai
  • URL: https://api.signalraven.ai/api/me/signals/{id}/comments
  • Auth: none declared

Path parameters

idstring uuid required

Request body

bodystring required
mentionedUserIdsstring[]

User IDs to @-mention. Server validates each is a current customer_users member and silently drops self-mentions.

Response

Comment created

idstring uuid required
authorUserIdstring uuid required
authorEmailstring email nullable required
authorRemovedboolean required

True when the author is no longer a member of this customer (their customer_users link was deleted). The FE renders "(removed)" alongside the email.

bodystring required

Empty string when deleted is true (the original text is redacted server-side to preserve privacy).

mentionedUserIdsstring[] required
mentionedEmailsstring[]
deletedboolean required
createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.