---
title: "Refresh Dataset"
method: POST
path: "/v1/datasets/{name}/acceleration/refresh"
tags: ["Datasets"]
---

# Refresh Dataset

`POST /v1/datasets/{name}/acceleration/refresh`

Trigger an on-demand refresh for an accelerated dataset.

The refresh only applies to `full` and `append` refresh modes (not
`changes` mode). Datasets without acceleration return 400 — the
previous `load: on_demand` flow has been removed; deferred datasets
(declared schema + `ready_state: on_registration`) are materialised
automatically on first query and do not need a manual trigger.

## Path parameters

- `name` string, required

## Request body

- RefreshOverrides — [`RefreshOverrides`] specifies the configurable options for a individual run of a refresh task.
  - `refresh_jitter_max` string, nullable — The maximum amount of jitter to add to the refresh. Defaults to the `refresh_jitter_max` specified in the spicepod, or 10% of the `refresh_check_interval`.
  - `refresh_mode` 'disabled' | 'full' | 'append' | 'changes' | 'caching' | 'snapshot'
  - `refresh_sql` string, nullable — The SQL statement used for this refresh. Defaults to the `refresh_sql` specified in the spicepod, if any.

## Response `201`

Dataset refresh triggered successfully

- MessageResponse
  - `message` string, required — The message describing the result of the request

## Other responses

- `400` — Dataset is not accelerated; nothing to refresh
- `404` — Dataset not found
- `500` — Internal server error occurred while processing refresh

## Changes

- **2026-05-05** `d375369a0861` — 1 info
  - added the new `snapshot` enum value to the request property `refresh_mode/oneOf[#/components/schemas/RefreshMode]/`
- **2025-11-26** `b730ce536cc5` — 1 info
  - added the new `caching` enum value to the request property `refresh_mode/oneOf[#/components/schemas/RefreshMode]/`
- **2025-03-18** `de97e196985b` — 2 info
  - added the new optional request property `refresh_jitter_max`
  - added the new optional request property `refresh_mode`
- **2025-03-18** `dd94571fef79` — 2 warning
  - removed the request property `refresh_jitter_max`
  - removed the request property `refresh_mode`

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/datasets/:name/acceleration/refresh/post.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/fb597a4eaa56/schema)