create_discussion_topic
Create discussion topics in Canvas courses with customizable settings for scheduling, student participation requirements, and topic visibility.
Instructions
Create a new discussion topic for a course.
Args:
course_identifier: The Canvas course code (e.g., badm_554_120251_246794) or ID
title: The title/subject of the discussion topic
message: The content/body of the discussion topic
delayed_post_at: Optional ISO 8601 datetime to schedule posting (e.g., "2024-01-15T12:00:00Z")
lock_at: Optional ISO 8601 datetime to automatically lock the discussion
require_initial_post: Whether students must post before seeing other posts
pinned: Whether to pin this discussion topic
Input Schema
Name | Required | Description | Default |
---|---|---|---|
course_identifier | Yes | ||
delayed_post_at | No | ||
lock_at | No | ||
message | Yes | ||
pinned | No | ||
require_initial_post | No | ||
title | Yes |
Input Schema (JSON Schema)
{
"properties": {
"course_identifier": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"title": "Course Identifier"
},
"delayed_post_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Delayed Post At"
},
"lock_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Lock At"
},
"message": {
"title": "Message",
"type": "string"
},
"pinned": {
"default": false,
"title": "Pinned",
"type": "boolean"
},
"require_initial_post": {
"default": false,
"title": "Require Initial Post",
"type": "boolean"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"course_identifier",
"title",
"message"
],
"type": "object"
}