# Improved guidance for access/permissions issues and documents publishing lifecycle

**Version:** v2.35.2

**Published:** September 22, 2026

## 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.

