list_generation_events
Workspace Analytics & Billing: every RUN of ONE Enterprise workspace, one row each, oldest first. Needs a workspace reporting key (wdr_report_…, made by the workspace Owner) for that workspace, or your own sign-in as its Owner or Admin (every run) or Member (only your own runs). A run = one generation job (a retry is a new run), or one step charged outside a job (a Cinematic Ads analysis, AI step or export, a Drama Studio chat turn, a recap, a Wan Motion Control step, subtitles, a Frame Studio export…), counted once, so the runs' credits add up to the Usage page. Each row of data: attempt_id (stable: the job id, or the step's ledger ref), job_id (null for a step outside jobs), source_channel (web, api_key, oauth, mcp; api = API key or OAuth before 10/10/2026; null = not recorded), actor_type (always human: every run is made by a person), user_id, team (the person's team when the run finished; "unclassified" = none), project_id and app_name (the Cinematic Ads project's app name), service: feature (a step outside jobs: what it was charged for, e.g. drama_chat), model_id (null for a step outside jobs) and model_name as the web shows them, provider (always "wandura"); output: kind (image / video / audio), count (files made; 0 unless succeeded), video_duration_seconds (measured from the file, not rounded) and duration_bucket, requested_duration_seconds (the length asked for) and requested_duration_bucket — buckets 0-15, 15-30, 30-60, 60-120, 120+ seconds, each upper bound included (15 is 0-15, 15.07 is 15-30), unknown = not measured or not asked; resolution (shorter side, e.g. 720p) and aspect_ratio (e.g. 9:16), both measured; preview_url (the CDN link: anyone with it can open it); status (succeeded, failed, running; there is no cancelled: a run the provider cancelled is failed), error_code, retry_of (the run this one retried); request_submitted_at, generation_started_at (+ generation_started_quality: exact, or approximate for models that do not report a start, which can be off by up to 2 minutes), generation_finished_at (when the result was ready; a run that failed at submit: when it was refunded); queue_time_seconds = started − submitted, generation_time_seconds = finished − started, request_to_result_seconds = finished − submitted, per run (never add parallel runs together); credits: gross_debit, refunded, net (= gross_debit − refunded), reserved (still held by a run in progress); cost_effective_usd = net × meta.cost_basis.effective_cents_per_credit (the workspace's one effective price), cost_list_usd = net × the list price (1 credit = $0.01); updated_at. A missing time is null, never 0, and every wait computed from it is null; meta.missing_fields lists each such field with the number of runs and why (one entry per cause). Range: a run belongs to the day it finished (a run still in progress: the day it was submitted). from (first day, included) and to (the day after the last, excluded), YYYY-MM-DD in Asia/Ho_Chi_Minh, at most 366 days; default the last 30 days including today. Paging: up to limit rows (1–1,000, default 1,000); when meta.next_cursor is not null pass it as cursor (with the same range and filters) for the next page. Sync: updated_since = the latest updated_at you stored returns only runs changed since. Free; at most 60 calls a minute per key or person. CSV: GET /api/v1/workspaces/{workspace_id}/reports/list_generation_events?format=csv (next page cursor in the X-Next-Cursor header).
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": {
"workspace_id": "<workspace_id>"
},
"name": "list_generation_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | The day after the last, excluded (YYYY-MM-DD, Asia/Ho_Chi_Minh). Default: tomorrow. At most 366 days after `from`. | |
| app | No | Only runs of this app (app_name: the Cinematic Ads project's app name). | |
| from | No | First day, included (YYYY-MM-DD, Asia/Ho_Chi_Minh). Default: 30 days before `to`. | |
| team | No | Only runs of this team, as the report names it ("unclassified" = people with no team). | |
| limit | No | Rows per page. | |
| cursor | No | meta.next_cursor of the previous page, unchanged. | |
| status | No | Only runs in this state. | |
| channel | No | Only runs that came this way. | |
| feature | No | Only runs of this feature (a feature from list_services, or what a step outside jobs was charged for: cinematic_ads_analysis, cinematic_ads_ai, cinematic_ads_export, drama_chat, …). | |
| user_id | No | Only this person's runs (a user id from list_workspace_members). | |
| model_id | No | Only runs of this model (a model_id from list_services; older names of the same model are included). | |
| project_id | No | Only runs of this project (a Cinematic Ads or Drama Studio project id). | |
| resolution | No | Only videos of this measured resolution, e.g. 720p (the shorter side in pixels). | |
| output_kind | No | Only runs making this kind of output. | |
| workspace_id | Yes | The workspace: the one the reporting key belongs to, or one you are a member of. | |
| updated_since | No | Only runs changed after this time (to the second), e.g. the latest updated_at you stored. | |
| duration_bucket | No | Only videos whose measured length is in this bucket. | |
| requested_duration_bucket | No | Only videos whose requested length is in this bucket. |