Fiveable for AP Teachers

Update assignment draft

update_assignment_draft

Destructive

Changes a draft's title, instructions, AP Calculus course, classes, dates, settings or sections. Existing section ids identify sections to remove. Published assignments cannot be changed here. Returns an undoId for restoring the previous draft.

Input Schema

TableJSON Schema

Name	Required	Description
`dueAt`	No	Default due time for every class.
`title`	No
`classes`	No	Replaces the class targets.
`settings`	No	Merged into the current settings.
`addSections`	No
`availableAt`	No	When it opens, ISO with offset.
`assignmentId`	Yes
`instructions`	No
`courseVariant`	No	AP Calculus only: switch the draft to ap-calc-ab or ap-calc-bc. Its multiple choice, free-response and diagnostic sections must be removed in the same call (add new ones there too); readings stay.
`resultRelease`	No	When students see results.
`removeSectionIds`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`text`	No	Readable tool result text for clients that consume structured output.
`status`	Yes	Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 19, 2026

changedInput schema / properties / addSections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "When drawing from units, skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "questionIds": {
-        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
-        "items": {
-          "pattern": "^(mcq:)?[\\w-]+$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "description": "Units to draw questions from. Omit when only using questionIds.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "style",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "parts": {
-        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
-        "items": {
-          "pattern": "^[A-Za-z]$",
-          "type": "string"
-        },
-        "maxItems": 12,
-        "minItems": 1,
-        "type": "array"
-      },
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "When drawing from units, skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "questionIds": {
+        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
+        "items": {
+          "pattern": "^(mcq:)?[\\w-]+$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "description": "Units to draw questions from. Omit when only using questionIds.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "style",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "focus": {
+        "const": "introduction",
+        "description": "AP World, APUSH or AP Euro DBQ or LEQ only: students write just the introduction (contextualization and a thesis), scored on the AP rubric's Thesis/Claim and Contextualization points (2 points). Omit for the whole essay. Can't be combined with parts.",
+        "type": "string"
+      },
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 15, 2026

changedInput schema / properties / addSections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "Skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Total questions in this section.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "questionCount",
-      "style",
-      "units",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "parts": {
-        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
-        "items": {
-          "pattern": "^[A-Za-z]$",
-          "type": "string"
-        },
-        "maxItems": 12,
-        "minItems": 1,
-        "type": "array"
-      },
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "When drawing from units, skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "questionIds": {
+        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
+        "items": {
+          "pattern": "^(mcq:)?[\\w-]+$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "description": "Units to draw questions from. Omit when only using questionIds.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "style",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 14, 2026

changedInput schema / properties / addSections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "Skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Total questions in this section.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "questionCount",
-      "style",
-      "units",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "Skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Total questions in this section.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "questionCount",
+      "style",
+      "units",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

First observedOct 1, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, so the safety bar is lower; the description still adds real context beyond them by disclosing the published-assignment restriction and the undoId recovery path. It does not describe merge vs. replace semantics for settings or partial-failure behavior, which keeps it out of 5 territory.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, zero filler, with the scope of changes front-loaded and the constraint and return value following. Every sentence carries distinct information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter destructive mutation with an output schema (so return format needn't be re-explained), the description covers the key constraint and recovery mechanism. Gaps remain around how settings are merged and how addSections/removeSectionIds interact, but nothing critical to a correct call is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 55%, so the schema documents some but not all parameters. The description lists the updatable fields and clarifies that section ids in the payload denote removals, but it adds little syntax or format detail (dates, settings merging) beyond what the schema provides. Baseline 3 fits.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (changes) and resource (a draft) plus the concrete field list it can touch, which separates it from updaters like update_class or update_student. The 'Published assignments cannot be changed here' clause further scopes it, though no sibling tool is named explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear when-not ('Published assignments cannot be changed here') and an inline how-to for section removal ('Existing section ids identify sections to remove'). It stops short of naming the alternative tool an agent should reach for when the assignment is already published.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Fiveable for AP Teachers tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Update assignment draft

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources