delete_announcement

Remove announcements from Canvas courses by specifying the course identifier and announcement ID to manage course content effectively.

Instructions

    Delete an announcement from a Canvas course.

    Announcements are technically discussion topics in Canvas, so this uses
    the discussion_topics endpoint to delete them.

    Args:
        course_identifier: The Canvas course code (e.g., badm_554_120251_246794) or ID
        announcement_id: The Canvas announcement/discussion topic ID to delete

    Returns:
        String describing the deletion result with status and title

    Raises:
        HTTPError:
            - 401: User doesn't have permission to delete the announcement
            - 404: Announcement not found in the specified course
            - 403: Editing is restricted for this announcement

    Example usage:
        result = delete_announcement("60366", "925355")
        print(f"Result: {result}")

Input Schema

TableJSON Schema

Name	Required	Description	Default
`course_identifier`	Yes
`announcement_id`	Yes

Implementation Reference

src/canvas_mcp/tools/discussions.py:901-956 (handler)

Core handler function that implements the 'delete_announcement' tool. Fetches announcement details, performs DELETE request to Canvas API /courses/{course_id}/discussion_topics/{announcement_id}, and returns success/error message with title.

@mcp.tool()
@validate_params
async def delete_announcement(
    course_identifier: str | int,
    announcement_id: str | int
) -> str:
    """
    Delete an announcement from a Canvas course.

    Announcements are technically discussion topics in Canvas, so this uses
    the discussion_topics endpoint to delete them.

    Args:
        course_identifier: The Canvas course code (e.g., badm_554_120251_246794) or ID
        announcement_id: The Canvas announcement/discussion topic ID to delete

    Returns:
        String describing the deletion result with status and title

    Raises:
        HTTPError:
            - 401: User doesn't have permission to delete the announcement
            - 404: Announcement not found in the specified course
            - 403: Editing is restricted for this announcement

    Example usage:
        result = delete_announcement("60366", "925355")
        print(f"Result: {result}")
    """
    course_id = await get_course_id(course_identifier)

    # First, get the announcement details to return meaningful information
    announcement = await make_canvas_request(
        "get", f"/courses/{course_id}/discussion_topics/{announcement_id}"
    )

    if "error" in announcement:
        return f"Error fetching announcement details: {announcement['error']}"

    announcement_title = announcement.get("title", "Unknown Title")

    # Proceed with deletion
    response = await make_canvas_request(
        "delete", f"/courses/{course_id}/discussion_topics/{announcement_id}"
    )

    if "error" in response:
        return f"Error deleting announcement '{announcement_title}': {response['error']}"

    course_display = await get_course_code(course_id) or course_identifier
    return f"Announcement deleted successfully from course {course_display}:\n\n" + \
           f"ID: {announcement_id}\n" + \
           f"Title: {announcement_title}\n" + \
           "Status: deleted\n" + \
           "Message: Announcement deleted successfully"

src/canvas_mcp/tools/discussions.py:17-19 (registration)
The register_discussion_tools function decorates and registers the delete_announcement handler (and other discussion tools) with the MCP server using @mcp.tool().
```
def register_discussion_tools(mcp: FastMCP):
    """Register all discussion and announcement MCP tools."""
```
src/canvas_mcp/server.py:49-49 (registration)
Invocation of register_discussion_tools(mcp) in register_all_tools, which registers the delete_announcement tool among others.
```
register_discussion_tools(mcp)
```

src/canvas_mcp/core/types.py:39-48 (schema)

Type definition for AnnouncementInfo, relevant for handling announcement data structures in Canvas API responses.

class AnnouncementInfo(TypedDict, total=False):
    id: int | str
    title: str
    message: str
    posted_at: str | None
    delayed_post_at: str | None
    lock_at: str | None
    published: bool
    is_announcement: bool

Canvas MCP Server