---
title: "Trigger a Manual Data Refresh"
method: POST
path: "/data/v2/refreshes"
tags: ["Data refresh"]
---

# Trigger a Manual Data Refresh

`POST /data/v2/refreshes`

Trigger on-demand data refresh for an entity that has an active consent

## Query parameters

- `async` boolean
- `page` integer
- `size` integer
- `entity_id` string, uuid
- `meta` string

## Request body

- TriggerDataRefreshRequestBody
  - `entity_id` string, uuid, required — The entity_id you're querying for, which is created by LinkSDK `.connect()` function.

## Response `200`

OK

- TriggerDataRefreshResponseBody
  - `refresh_id` string, uuid, required — Refresh ID for the request created by server
  - `status` string, required — Status of the data refresh which will be
  - `message` string, required — Message
  - `timestamp` string, date-time, required — Data refresh trigger date time

## Other responses

- `400` — Bad Request
- `403` — Forbidden - Consent expired
- `404` — Entity not found
- `429` — Too Many Requests - Duplicated request
- `500` — Internal Server Error

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)
