Skip to main content
GET
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
Returns the resource’s visibility and the people and teams it is shared with. The shape is the same as Get Task Sharing, so one client can read sharing for every kind of resource. visibility is private (only the people and teams listed) or customer (anyone in your organisation). A session someone published from the Wordsmith app reads public; the API never sets that. In users, role is owner for the person who created the resource and shared for everyone else. access_level is write for the resource’s admins and read for its viewers. Sessions differ. A session’s creator always has access, so they are not listed. write on a session lets someone continue and edit it, not change its sharing: only the creator can do that. A review has no sharing of its own: it is shared through the session it belongs to. Assistants read the same information through the MCP tool get_resource with include: ["sharing"], for playbooks, blueprints and tasks.

​
Authentication

Requires an API key, or an OAuth token with the read scope of the resource type: As in the Wordsmith app, only an admin of a repository, playbook or blueprint can see who it is shared with. Anyone who can read a report or a session can see its sharing.

​
Path parameters

​
string
required
One of repositories, reports, playbooks, blueprints or sessions. Tasks keep their own sharing route.
​
string
required
The resource id.

​
Response

Returns 200 with visibility, users and teams.

​
Errors