--- title: reports.run | Doing Work API description: Run a saved report now: its date range is worked out on the shop's calendar (or around as_of), and the report operation runs with the caller's own. url: https://doingwork.work/docs/reference/reports-run/ --- # reports.run Run a saved report now: its date range is worked out on the shop's calendar (or around as_of), and the report operation runs with the caller's own permissions. Returns the exact input used and the operation's result. | | | |---|---| | Who | Agents can call this | | REST | `POST /v1/reports/saved/run` | | MCP tool | `reports_run` | | Writes | no | | Area | [Costs, expenses and reports](https://doingwork.work/docs/reference/#costs-expenses-and-reports) | ## When to use it Run a saved report now: its date range is worked out on the shop's calendar (or around as_of), and the report operation runs with the caller's own permissions. Returns the exact input used and the operation's result. ## What to tell the owner Tell them what you found in plain words. Don't read back raw fields. ## Input | Field | Type | Required | |---|---|---| | `report_id` | string (uuid) | yes | | `as_of` | string | no | ## Example ```http POST https://doingwork.work/v1/reports/saved/run content-type: application/json Idempotency-Key: 3f1c... { "report_id": "00000000-0000-4000-8000-000000000000" } ``` ## Output | Field | Type | Always there | |---|---|---| | `report` | object | yes | | `report.report_id` | string (uuid) | yes | | `report.name` | string | yes | | `report.op_id` | string | yes | | `report.params` | object | yes | | `report.date_range` | ['string', 'null'] | yes | | `report.created_by` | string (uuid) | yes | | `report.created_at` | string (date-time) | yes | | `report.updated_at` | string (date-time) | yes | | `input` | object | yes | | `result` | object | yes | ```json { "report": { "report_id": "00000000-0000-4000-8000-000000000000", "name": "Ruiz Plumbing", "op_id": "00000000-0000-4000-8000-000000000000", "params": {}, "date_range": "...", "created_by": "00000000-0000-4000-8000-000000000000", "created_at": "...", "updated_at": "..." }, "input": {}, "result": {} } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |