Share a website, app, agent, or skill by email
share_serviceShare a website, app, agent, or skill by email: each address is mailed a link, whatever the service's access mode, and sharing does not change who else can reach it. The link comes from Valet and opens the service; the recipient needs no Valet account of their own, only the link, so anyone holding the email can open it and forwarding it forwards access. On a website that holds a connector, the recipient's pages can call the connector's tools. An app runs server code, so a person it is shared with can use everything the app does, including anything that changes data. An agent can be shared only on a server with agent outside access turned on. Sharing again with an address that already has access re-sends the same link rather than creating a second one. Returns one result per address: its share id, whether the share was created or resent, and whether the mail went out. A share is recorded even when the mail fails. Requires connecting a Valet account.
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>",
"emails": "<emails>"
},
"name": "share_service"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | The kind you believe the named service is, as a safeguard against sharing the wrong thing. Omit to share whatever the name holds. | |
| name | Yes | The website's, app's, agent's, or skill's name, as list_services shows it: the one to share. | |
| emails | Yes | Who receives the link, one email address each. | |
| message | No | A note to the recipients, quoted in the email beside the link, so they know why they were sent it before they open it, such as what you want them to look at. | |
| org_name | No | The Valet organization the website, app, agent, or skill belongs to. Omit to use the organization the account joined first. | |
| access_ttl | No | How long access lasts once the link is first opened, after which the link stops working, such as 30m or 7d. Omit for access that never expires this way. Composes with expires_in: the unopened deadline governs until the first open replaces it. | |
| expires_in | No | How long from now the link works if nobody has opened it yet, such as 24h or 7d. Omit for a link that never expires this way. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | Yes | Name of the Valet organization the call acted in. | |
| kind | Yes | Kind of the service shared: site, app, agent, or skill. | |
| name | Yes | Name of the website, app, agent, or skill that was shared. | |
| results | Yes | One entry per address, in the order the call named them. |