Document archive/deletion reasons and group description on create

[tommoor]

Documents API schema changes from pull requests merged in outline/outline over the last day.

Changes

Archive & deletion reasons (outline/outline#13784)

• Add optional reason input (string, max 2000, nullable) to:
  • documents.archive
  • documents.delete
  • collections.archive
  • collections.delete
• Add optional deprecatedReason input (string, max 2000, nullable) to documents.update and collections.update. This can only be updated on an archived/deleted document or archived collection.
• Add the read-only deprecatedReason field to the Document and Collection response schemas. The reason supplied at archive/delete time is stored and returned here.

Group description on create (outline/outline#13791)

• Document the description input on groups.create. The endpoint now stores the description when a group is created (the Group response schema already documents description).

Notes

• Only spec3.yml was edited by hand; spec3.json was regenerated by the pre-commit hooks (yamlToJSON.js).
• Spectral lint, operation ID, and sort checks all pass.
• Reviewed the other PRs merged in the same window; the remainder were UI, editor, CI/test, or validation-only changes with no public API input/output shape changes (e.g. #13800 "Validate custom theme colors" only strengthens team.update hex validation without changing the schema shape). Dependabot PRs ignored.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RRbhSVmsWtuy28THeRA5cA

---

Generated by Claude Code