Rate Entry
rate_entryAdds or removes a like on a discussion entry when the instructor enabled ratings, updating the like count others see.
Instructions
Like (rating 1) or remove your like (rating 0) on a discussion entry, where the instructor enabled ratings. Others see the like count. [NEEDS CONFIRMATION: call it once for a preview and a confirm_token, show the preview to the user, and only if they say yes call it again with the same arguments, confirm=true and that confirm_token. Apps that can ask the user directly show a confirmation instead.]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"course_id": "<course_id>",
"topic_id": "<topic_id>",
"entry_id": "<entry_id>",
"rating": "<rating>"
},
"name": "rate_entry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rating | Yes | 1 to like, 0 to remove | |
| confirm | No | Set to true together with confirm_token to carry out a request you already previewed. | |
| entry_id | Yes | Discussion entry ID (numeric string). Get it from get_full_topic_view or list_entries. | |
| topic_id | Yes | Discussion topic ID (numeric string). Get it from list_topics. | |
| course_id | Yes | Canvas course ID, a numeric string such as "12345". Get it from list_courses. | |
| confirm_token | No | The one-time token from the preview. Only use it after the user has said yes. |