Set website, app, agent, or skill access
set_service_accessSet who can reach a website, app, agent, or skill: public serves it to anyone who has the link, private serves it to members of the organization that owns it after they sign in to Valet, and to anyone a member has shared it with through share_service, who needs no Valet account, and password serves it to anyone who enters a shared visitor password. Apps can be changed only on a server with app access turned on. An agent opens to public or password access only on a server with agent outside access turned on. Changing the mode revokes the access the old mode granted, so confirm the new mode with the user before calling. Requires connecting a Valet account.
Password mode does not take the password. The answer carries a request whose url the person opens, signed in to Valet, to set the shared visitor password; the mode changes only when they do. Say in reason why it needs a password. Give the person the url, then follow the request with get_request. Never ask for the password in this conversation. Otherwise the answer carries the access mode now in force and the url, version, and published_at of the live release when the service has one.
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": {
"name": "<name>",
"mode": "<mode>"
},
"name": "set_service_access"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | The kind you believe the named service is, as a safeguard against changing the wrong thing. Omit to change whatever the name holds. | |
| mode | Yes | Who may open the service from now on; the tool description says whom each mode lets in. Confirm the choice with the person first, because a narrower mode shuts out people who could open it before. | |
| name | Yes | The website's, app's, agent's, or skill's name, as list_services shows it: the one whose access to set. | |
| reason | No | Shown to the person on the request page to explain why the values are needed, so they can decide whether to enter them, such as: The site holds client drafts, so visitors need a password to open it. | |
| org_name | No | The Valet organization it belongs to. Omit to use the organization the account joined first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | Yes | Name of the Valet organization the call acted in. | |
| url | No | Address the service is served at. Absent when it has none, such as a service whose route is gone. | |
| kind | Yes | Kind of the service: site, app, agent, or skill. | |
| name | Yes | Name of the service. | |
| access | Yes | Who can reach the service: public, private, or password. Never includes the visitor password. While a password request is pending, the mode still in force. | |
| request | No | The request a person completes in the dashboard to enter a value that must not pass through this conversation. Absent when nothing needs a person. | |
| version | No | Version of the live release. Absent for a service nobody has published. | |
| published_at | No | RFC 3339 time the live release was created. Absent for a service nobody has published. |