Share an Artifact
share_artifactSet who can open an Artifact you own. audience picks the rule; share_with is the complete list of named people (it replaces the previous list; omit it to keep the current one). Going public deletes every comment thread, so a public change on an Artifact with threads is refused unless delete_threads is true. Returns the URL to send.
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": {
"artifact_id": "<artifact_id>",
"audience": "<audience>"
},
"name": "share_artifact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listed | No | Show it in listings (the company library, public discovery) rather than link-only. Default false. | |
| audience | Yes | Who can open the link. owner: only you. users: the people in share_with. public: anyone with the link. | |
| share_with | No | People to grant access by email (or uid), with a role. [{ "email": "ana@acme.com", "role": "viewer" }]. viewer opens it; editor can also publish new content. Implies audience "users" when audience is omitted. | |
| artifact_id | Yes | The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…. | |
| delete_threads | No | Allow going public on an Artifact that has comment threads, deleting them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| grants | Yes | ||
| artifact_id | Yes | ||
| audience_mode | Yes | ||
| discoverability | Yes | ||
| public_sharing_allowed | No | ||
| external_sharing_allowed | No |