Improved guidance for access/permissions issues and documents publishing lifecycle

Published: September 22, 2026

v2.35.2

Improvements

  • OAuth access: Explain when a connection cannot access a project in another Sanity organization and how to authorize access.
  • Document permissions: Explain draft and published document access and how to update the role when a write is denied.
  • Project access: Show the active Sanity account in authorization errors alongside recovery guidance.
  • create_release tool: Clarify that publish type and date record intent only. Schedule, publish, archive, and delete releases in Sanity Studio or through the HTTP Actions API.
  • Document references: When a strong reference points to an unpublished document, explain the cause and link to the relevant Sanity documentation.
  • Document tools: Accept common equivalent input shapes and provide clearer examples for query_documents, patch_documents, and publish_documents.

Fixes

  • Request size: Return a clear error when MCP requests exceed the 100 KB limit.
  • patch_documents tool: Recover when a draft or release version appears between lookup and write. When no editable document exists, report every document ID checked.

Related documentation

Loading...
Improved guidance for access/permissions issues and documents publishing lifecycle | Sanity Docs