Comment
A Comment is an internal note by a Worker about a Thing, never sent to a Contact.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
body | text | required | What it says. |
Object
{
"$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, inversecomments. - A Comment’s author is one Worker: every Comment names the Worker, human or agent, who wrote it.
author, inversewrites.
Verbs
createCreates a Comment.POST /{namespace}/commentsgetReturns one Comment by id.GET /{namespace}/comments/{id}listReturns Comments, newest first, one page at a time.GET /{namespace}/commentsupdateChanges the given properties of a Comment.PATCH /{namespace}/comments/{id}deleteDeletes a Comment; its history is kept.DELETE /{namespace}/comments/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Comment.create | Yes | Yes | Yes | No |
Comment.get | Yes | Yes | Yes | Yes |
Comment.list | Yes | Yes | Yes | Yes |
Comment.update | Yes | Yes | Yes | No |
Comment.delete | Yes | Yes | Yes | No |
Call it
Add a comment to RouteWise.Example
A support Agent leaves a Comment on a Conversation: refund approved,. The Contact never sees it.