# Discussion Thread
Discussion threads can be created for all realms except users. The operations below are available for the following realms: `districts/{id}`, `schools/{id}`, `sections/{id}`, and `groups/{id}`.
:::note
Discussion threads exist in districts, schools, groups, and sections.
:::
## Fields
| Field | Name | Description | Type |
| ---------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| `id`\* | Schoology Discussion ID | The internal Schoology ID of the discussion. | `string` |
| `title`\* | Title | The thread title. | `string` |
| `body` | Thread Body | The thread body. | `string` |
| `graded` | Graded | Whether or not the discussion is graded. Allowed values: `0`, `1`. | `integer` |
| `due` | Due Date | When the assignment is due. Format: `YYYY-MM-DD HH:MM:SS`. | `datetime (YYYY-MM-DD HH:MM:SS)` |
| `grade_item_id` | Grade Item ID | The Id of the grade item associated with this discussion (used for grades). | `integer` |
| `grading_scale` | Grading Scale | The ID of the grading scale for this assignment. For no grading scale, use `0`. Course grading scales can be found on the course Grade Setup page. (default: `0`) | `integer` |
| `grading_period` | Grading Period | The grading period ID to which this assignment belongs. For "Other", use `0`. (default: `0`) | `integer` |
| `grading_category` | Grading Category | The grading category ID to which this assignment belongs. (default: `0`) | `integer` |
| `max_points` | Maximum Points | The maximum number of points for this assignment (excl. extra credit). (default: `100`) | `float` |
| `factor` | Factor | The relative weight of this assignment. (default: `1.0`) | `float` |
| `is_final` | Is a Final | Mark this assignment as a midterm or final. Allowed values: `0`, `1`. (default: `0`) | `integer` |
| `published` | Published | Whether or not the discussion is published. Only applies to section discussions NOT associated with topics. Allowed values: `0`, `1`. (default: `1`) | `integer` |
| `require_initial_post` | Requires Initial Post | Flag indicating whether a member needs to participate before seeing other member posts. Allowed values: `0`, `1`. (default: `0`) | `integer` |
| `count_in_grade` | Count in Grade | Can be used for materials such as pre-assessments or practice work, allowing parents/students to see progress while knowing the score is not impacting a students calculated grade. This field can be used in a POST or PUT operation. It only applies to Course Sections realm and Discussion Thread enabled for grading. Allowed values: `0`, `1`. (default: `1`) | `integer` |
| `collected_only` | Collected Only | Allows teachers to simply mark materials as completed or not; useful for collecting forms or documenting in-class participation. This field can be used in a POST or PUT operation. It only applies to Course Sections realm and Discussion Thread enabled for grading. Allowed values: `0`, `1`. (default: `0`) | `integer` |
| `auto_publish_grades` | Automatically Publish Grades | Assignment grades will be visible to students and guardians as soon as they are entered. Allowed values: `0`, `1`. (default: `1`) | `integer` |
\* = Required
## GET `{realm}/discussions`
View a list of discussion threads (paged). Optional query parameters: `with_attachments`, `with_tags`.
```json
{
"discussion": [
{
"id": 5692161,
"uid": 45552,
"title": "Example topic",
"body": "Let's talk about APIs",
"weight": 20,
"graded": 0,
"published": 1,
"available": 1,
"completed": 0,
"count_in_grade": 1,
"collected_only": 0,
"auto_publish_grades": 1,
"comments_closed": 0,
"completion_status": "",
"links": {
"self": "http:\/\/...\/discussions\/5692161"
}
},
{
"id": 5692163,
"uid": 45552,
"title": "Example topic 2",
"body": "Let's talk about APIs",
"weight": 30,
"graded": 0,
"published": 1,
"available": 1,
"completed": 0,
"count_in_grade": 1,
"collected_only": 0,
"auto_publish_grades": 1,
"comments_closed": 0,
"completion_status": "",
"links": {
"self": "http:\/\/...\/discussions\/5692163"
}
}
],
"total": 2,
"links": {
"self": "http:\/\/...\/discussions?start=0&limit=20"
}
}
```
```xml
5692161
45552
Example topic
Let's talk about APIs
20
0
1
1
0
1
0
1
0
http://.../discussions/5692161
5692163
45552
Example topic 2
Let's talk about APIs
30
0
1
1
0
1
0
1
0
http://.../discussions/5692163
2
http://.../discussions?start=0&limit=20
```
## GET `{realm}/discussions/{id}`
View a specified discussion thread. Optional query parameters: `with_attachments`, `with_tags`.
```json
{
"id": 5692161,
"uid": 45552,
"title": "Example topic",
"body": "Let's talk about APIs",
"weight": 20,
"graded": 0,
"published": 1,
"available": 1,
"completed": 0,
"count_in_grade": 1,
"collected_only": 0,
"auto_publish_grades": 1,
"comments_closed": 0,
"completion_status": ""
}
```
```xml
5692161
45552
Example topic
Let's talk about APIs
20
0
1
1
0
1
0
1
0
```
## POST `{realm}/discussions`
Create a discussion thread.
**Content** An object containing discussion thread fields
```json
{
"title": "Example topic",
"body": "Let's talk about APIs",
"graded": "0"
}
```
```xml
Example topic
Let's talk about APIs
0
```
**Return** An object containing discussion thread fields
```json
{
"id": 5692161,
"uid": 45552,
"title": "Example topic",
"body": "Let's talk about APIs",
"weight": 20,
"graded": 0,
"published": 1,
"available": 0,
"completed": 0,
"count_in_grade": 1,
"collected_only": 0,
"auto_publish_grades": 1,
"comments_closed": 0,
"links": {
"self": "http:\/\/...\/discussions\/5692161"
}
}
```
```xml
5692161
45552
Example topic
Let's talk about APIs
20
0
1
0
0
1
0
1
0
http://.../discussions/5692161
```
## PUT `{realm}/discussions/{id}`
Modify a discussion thread.
**Content** An object containing discussion thread fields
```json
{
"body": "Let's talk about APIs and REST clients"
}
```
```xml
Let's talk about APIs and REST clients
```
## DELETE `{realm}/discussions/{id}`
Delete a discussion thread (cannot be undone).