Read an Artifact's analytics
read_artifact_analyticsWho opened a document or page you own, edit, or published: views, signed-in readers, and which Version each last opened. On a company document or page it names every member who can open it, with their opens and, for a document, whether they read the latest version; company admins read it for every company item. Use it to answer 'who has read the policy?' or 'has the team opened the dashboard?'. A reader list carries email addresses, so answer the question asked rather than pasting it.
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>"
},
"name": "read_artifact_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artifact_id | Yes | The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| readers | Yes | Company items only; null on a personal one. | |
| versions | No | ||
| view_count | Yes | ||
| artifact_id | Yes | ||
| last_viewed_at | No | ||
| unique_viewers | Yes | ||
| published_version_number | No |