Set which Roles can open a Hosted App
set_app_accessReplace the Roles that may open a Hosted App. All Administrators always have access; [] permits Administrators only. End users and Administrator cannot be listed. Any Administrator may manage any app. Sharing grants the current version's recorded Requests to these Roles everywhere, including MCP and the Data API. It never grants the version's calls_without_grant. The built-in Member Role is everyone in this Project, including anyone invited later, so MCP cannot add it: a call whose role_ids adds Member is refused with member_share_requires_confirmation and a human_link to the Application page, where an Administrator confirms it; give the person that link. A list that keeps a saved Member share is not refused. Pass preview: true to see what the save would do without changing anything: changed, access_changes, and the Member refusal when it applies. Returns changed and access_changes for Roles whose reach grew; each added_requests entry carries changes_data: true when the Request can change data (any effect but READ). When role_ids names a Role and seat-taking invitations are restricted, the result carries invitation_eligibility, the same note list_users reports, including upgrade_url, and the share still succeeds. [] permits Administrators only and carries no such note. An offer Central did not confirm is not that restriction.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"role_ids": "<role_ids>"
},
"name": "set_app_access"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | App slug; provide exactly one of slug or app_id | |
| app_id | No | App UUID; provide exactly one of slug or app_id | |
| preview | No | true answers what this save would do — changed, access_changes and any Member refusal — and writes nothing; omitted or false saves | |
| role_ids | Yes | Role UUIDs; [] permits Administrators only; End users and Administrator cannot be listed |