---
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.

This endpoint triggers an on-demand refresh for an accelerated dataset.
The refresh only applies to `full` and `append` refresh modes (not `changes` mode).

## Path parameters

- `name` string, required

## Request body

- AccelerationRequest
  - `refresh_sql` string, nullable — SQL statement used for the refresh. Defaults to the `refresh_sql` specified in the spicepod.

## Response `201`

Dataset refresh triggered successfully

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

## Other responses

- `400` — Acceleration not enabled for the dataset
- `404` — Dataset not found
- `500` — Internal server error occurred while processing refresh

## Changes

- **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/dd94571fef79/schema)