Add audit logging for recap API endpoints

[Combs7th]

@claude, Let's update the Mattermost Product Documentation to reflect the administrator observability experience for recap-related audit logging from Mattermost server v11.5 onward captured via engineering PR mattermost/mattermost#34929

Before proposing any changes:

• First, make an assessment on whether or not a doc update is even necessary for this PR.
• If it is necessary: Identify the existing audit logging, security, or administrator monitoring documentation page(s) most closely related.
• Analyze the writing style, tone, structure, headings, and formatting patterns used on those pages.

When drafting updates:

• Match the existing voice and writing patterns of the page as closely as possible.
• Follow the same heading hierarchy and formatting conventions already in use.
• Avoid introducing new sections unless absolutely necessary.
• Keep the update minimal and focused on observable audit log behavior, not implementation details.

Focus the docs update on:

• What has changed from the System Admin / Risk Assessor perspective
• The new audit events generated by recap API operations
• The fact that recap operations now log associated channel_ids, indicating implicit channel content access
• When or why an administrator might see these events while reviewing audit logs for compliance, monitoring, or troubleshooting

Relevant recap audit events introduced by this PR include:

• createRecap
• getRecap
• getRecaps
• markRecapAsRead
• regenerateRecap
• deleteRecap

DO NOT suggest changes to the following docs pages:

• changelogs
• important upgrade notes
• version archive
• removed and deprecated features
• unsupported legacy releases

[claude]

Claude finished @Combs7th's task in 3m 54s —— View job • claude/issue-8783-20260306-0107 • Create PR ➔

---

Tasks

• Gather context and understand the request
• Read CLAUDE.md for repo-specific guidelines (no CLAUDE.md present)
• Find existing audit logging documentation pages
• Analyze writing style and structure of relevant pages
• Draft and implement documentation updates
• Commit and push changes

---

Assessment: A documentation update is necessary. The source/administration-guide/comply/embedded-json-audit-log-schema.rst page is the correct target — it is the canonical reference for all audit event_name values, organized as tables grouped by feature area.

What was changed: Added a new AI Recap Events section to the "Audit event types" area of the embedded JSON audit log schema page. The section follows the same RST grid table format, heading hierarchy, and description style used throughout the file. It documents all six new events introduced in Mattermost server v11.5:

Event Name	Description
createRecap	Creating channel recaps
deleteRecap	Deleting channel recaps
getRecap	Retrieving channel recaps
getRecaps	Retrieving multiple channel recaps
markRecapAsRead	Marking channel recaps as read
regenerateRecap	Regenerating channel recaps

A note was also added below the table to surface the channel_id field for administrators reviewing audit logs for compliance or access monitoring purposes.