---
title: "Refresh a Dataset in a report"
method: POST
path: "/{account}/reports/{report}/runs"
---

# Refresh a Dataset in a report

`POST /{account}/reports/{report}/runs`

## Request

- Base URL: `https://modeanalytics.com/api`
- URL: `https://modeanalytics.com/api/{account}/reports/{report}/runs`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/thoughtspot/apis/mode/docs/:account/reports/:report/runs/post.ts> (a function with typed inputs; its response is checked against the schema)

Pulls in the latest run available in Mode for the `Dataset` in a specified report and does not re-run the `Dataset`

## Path parameters

- `account` string, required
- `report` string, required

## Request body

- RefreshImportedDatasetRequestBody
  - `report` object, required
    - `dataset_tokens` unknown[]: An array of `Dataset` objects containing only their token
      - unknown

## Response `202`

`ReportRun` Accepted

- ReportRun
  - `token` string, required
  - `state` 'pending' | 'enqueued' | 'cancelled' | 'failed' | 'succeeded' | 'completed' | 'running_notebook', required
  - `parameters` unknown
  - `created_at` string, required
  - `updated_at` string, required
  - `completed_at` string, required
  - `purge_started_at` string, required
  - `purge_completed_at` string, required
  - `python_state` 'none' | 'pending' | 'failed' | 'submitted' | 'succeeded'
  - `form_fields` unknown[]
    - unknown
  - `is_latest_report_run` string, required
  - `is_latest_successful_report_run` string, required
  - `report_has_failures_since_last_success` string, required
  - `pusher_channel_name` string
  - `_links` ReportRunLinks, required
    - `latest_successful_report_run_api_url` Link
      - `href` string, required
      - `templated` boolean
    - `self` Link, required
      - `href` string, required
      - `templated` boolean
    - `content` Link
      - `href` string, required
      - `templated` boolean
    - `preview` Link
      - `href` string, required
      - `templated` boolean
    - `account` Link, required
      - `href` string, required
      - `templated` boolean
    - `report_schedule` Link
      - `href` string, required
      - `templated` boolean
    - `executed_by` Link
      - `href` string, required
      - `templated` boolean
    - `share` Link
      - `href` string, required
      - `templated` boolean
    - `embed` Link
      - `href` string, required
      - `templated` boolean
    - `report` Link, required
      - `href` string, required
      - `templated` boolean
    - `clone` Link
      - `href` string, required
      - `templated` boolean
    - `query_runs` Link, required
      - `href` string, required
      - `templated` boolean
    - `python_cell_runs` Link
      - `href` string, required
      - `templated` boolean
    - `pdf_export` Link
      - `href` string, required
      - `templated` boolean
    - `web_edit_dataset` Link
      - `href` string, required
      - `templated` boolean
    - `web_clone` Link
      - `href` string, required
      - `templated` boolean
    - `web_external_url` Link
      - `href` string, required
      - `templated` boolean
  - `_embedded` unknown

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: `Report` not found

## Changes

- **2023-03-06** `28090c5af9c0`: 1 info
  - api operation id `runReport` removed and replaced with `refreshDataset`

[Operation history](https://skmtc.dev/thoughtspot/apis/mode/changes/:account/reports/:report/runs/post.md)

---

[API](https://skmtc.dev/thoughtspot/apis/mode.md) - [All operations](https://skmtc.dev/thoughtspot/apis/mode/llms.txt) - [OpenAPI document](https://skmtc.dev/thoughtspot/apis/mode/revisions/4c694c3fdeb1?raw)