Share a Hive report by link
share_reportDestructiveIdempotent
Create or update the Hive shared link for one report. A public link can be opened by anyone who has it, so your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | The title people see on the shared page. | |
| rotate | No | true issues a new link and retires the old one. | |
| reportId | Yes | The Hive report id. | |
| expiresAt | No | Optional ISO expiry, within the next year. | |
| recipients | No | Email addresses invited to an invite-only link. | |
| visibility | Yes | invite_only sends it to named addresses; public can be opened by anyone with the link. | |
| description | No | ||
| dynamicDate | No | true keeps the report’s date period live; false freezes today’s range into the link. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |