Save a Costory report with widgets, destinations, and a delivery schedule. Use when the user requests a saved or scheduled report. NOW sends immediately; recurring schedules enable future delivery. Delivery may be partial, and archiving the report does not retract messages already sent. New reports are creator-only (you get Admin). To share, call set_object_permissions after create — do not send PRIVATE/PUBLIC or teamId. The get_skill guide "reports" explains context-first workflow and DIGEST preview iteration. Put shared settings in `reportContext` (period required when query widgets are present: datePreset when a preset matches; plus metricId, common groupBy, currency, optional conditionsCel / scopeId). Query widgets inherit reportContext; specify only overrides. Schedule modes:
• NOW — create an on-demand report and immediately deliver it to every destination. DANGER ZONE: this sends real messages now. Summarize scope, schedule, and every destination, then ask the user to confirm before calling.
• UNSCHEDULED — save an on-demand draft without delivery.
• SCHEDULED — create a recurring report (DAILY / WEEKDAYS / WEEKLY / MONTHLY). DANGER ZONE: this authorizes future channel delivery. Summarize the recurring schedule and every destination, then ask the user to confirm before calling.
Optional `tagIds`: existing IDs from list_tags and/or `{ name, color? }` for new tags; color defaults to #6366F1; missing tags are created. Omit and `[]` both leave the report untagged. Widget types: DASHBOARD_PDF, GRAPH_SNAPSHOT, TOP_FLOP, TEXT, and DIGEST. A DASHBOARD_PDF widget renders an existing dashboard as a PDF — pass `{ type: "DASHBOARD_PDF", dashboardId: "<id from search>" }` (dashboardId required). TEXT widgets use `{ type: "TEXT", contentMarkdown }` (not dashboard `textContent`); optional `queries` plus `datePreset` or `from`/`to` store a chart override. DIGEST hierarchy: `reportContext.groupBy` (default root) + ordered `additionalGroupBy` (deeper levels); also supports thresholds. Per-widget override: set DIGEST `useDashboardGroupBy: false` to ignore `reportContext.groupBy` for that widget — the first `additionalGroupBy` item (or `queries[0].groupBy`) becomes the root; `false` requires at least one dimension. DIGEST accepts a per-widget `queries[0].filterCel` (CEL) — AND-combined with `reportContext.conditionsCel` by default (`extendDashboardConditions` defaults true), applied to both the comparison periods, and named by the AI summary. Use it for focused digests (e.g. Kubernetes only: `cos_cluster_name != null`) next to an unfiltered org-wide digest in the same report. DIGEST AI (opt-in, slower): `display` ("tree" default | "table" | "summary" for LLM executive narrative) and `enableAiInvestigation` (boolean, default false — per-node deep analysis, independent of display). When `scout` is set, do not offer those DIGEST AI knobs — the scout explains the send; leave DIGEST at tree-only unless the user independently asked for an AI digest write-up. DIGEST `aggBy` is Month or Week — never Period (Period is TOP_FLOP). Widget fields are documented once in preview_report_widget.widget; no preview call is required. Destinations: SLACK/TEAMS take `channelId`; EMAIL takes `email` (a single address, the literal ALL_ACTIVE_USERS to reach every active user, or destinations.email.self from list_available_destinations for "email me"). Mergeable same-type items (two emails, two Slack/Teams channels) are stored as one destination and share one execution; mixed types stay separate. Exclusive sentinels (`ALL_ACTIVE_USERS`, `SHARED_SLACK`) stay on their own destination and execution. Returns report URL and nextRunAt; NOW also returns execution URLs and per-destination status.
EXAMPLE monthly DIGEST: { schedule: { mode: "UNSCHEDULED" }, reportContext: { datePreset: "LAST_MONTH", groupBy: "cos_environment", metricId: "cost", currency: "USD" }, widgets: [{ type: "DIGEST", queries: [{ type: "cost", name: "a" }], aggBy: "Month", additionalGroupBy: ["cos_sub_account_id", "cos_service_name"], minAbsoluteDiff: 100, minRelativeDiff: 5, topLargestAbsoluteChange: 20, display: "summary", enableAiInvestigation: false }, { type: "DIGEST", title: "Kubernetes", queries: [{ type: "cost", name: "a", filterCel: "cos_cluster_name != null" }], aggBy: "Week" }], destinations: [{ destinationType: "SLACK", channelId: "C…" }] }
EXAMPLE namespace-rooted DIGEST (overrides reportContext.groupBy for this widget only): { schedule: { mode: "UNSCHEDULED" }, reportContext: { datePreset: "LAST_MONTH", groupBy: "cos_environment", metricId: "cost", currency: "USD" }, widgets: [{ type: "DIGEST", title: "Kubernetes", useDashboardGroupBy: false, queries: [{ type: "cost", name: "a" }], aggBy: "Month", additionalGroupBy: ["cos_namespace_reallocated", "cos_workload_name"] }], destinations: [{ destinationType: "SLACK", channelId: "C…" }] }
EXAMPLE GRAPH_SNAPSHOT + TOP_FLOP: { schedule: { mode: "SCHEDULED", period: "WEEKLY", weekday: 1, firstRunAt: "2026-08-04T10:00:00.000Z" }, reportContext: { metricId: "cost", currency: "USD", groupBy: "cos_service_name", datePreset: "LAST_WEEK" }, widgets: [{ type: "GRAPH_SNAPSHOT", title: "Cost by service — trailing weeks", queries: [{ type: "cost", name: "a", chartType: "LINE" }], datePreset: "TRAILING_14_WEEKS", aggBy: "Week" }, { type: "TOP_FLOP", title: "Last week movers by service", queries: [{ type: "cost", name: "a" }], aggBy: "Period", topN: 5, flopN: 5 }], destinations: [{ destinationType: "SLACK", channelId: "C…" }] }