Skip to content

Comment

A Comment is an internal note by a Worker about a Thing, never sent to a Contact.

Properties

PropertyTypeRequiredDescription
bodytextrequiredWhat it says.

Object

JSON
{
  "$id": "https://api.sb/shiftnote.app/comments/comment_1",
  "$type": "Comment",
  "body": "Example body"
}

Relationships

  • A Comment annotates one Thing: a Comment is an internal note on one Thing, never sent to a Contact. annotates, inverse comments.
  • A Comment’s author is one Worker: every Comment names the Worker, human or agent, who wrote it. author, inverse writes.

Verbs

  1. createCreates a Comment.
    POST /{namespace}/commentsdoComment.created
  2. getReturns one Comment by id.
    GET /{namespace}/comments/{id}readNo Event
  3. listReturns Comments, newest first, one page at a time.
    GET /{namespace}/commentsreadNo Event
  4. updateChanges the given properties of a Comment.
    PATCH /{namespace}/comments/{id}doComment.updated
  5. deleteDeletes a Comment; its history is kept.
    DELETE /{namespace}/comments/{id}doComment.deleted

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Comment.createYesYesYesNo
Comment.getYesYesYesYes
Comment.listYesYesYesYes
Comment.updateYesYesYesNo
Comment.deleteYesYesYesNo

Call it

Text
Add a comment to RouteWise.

Example

A support Agent leaves a Comment on a Conversation: refund approved, send confirmation. The Contact never sees it.