---
title: "Refresh Transform"
method: PATCH
path: "/v1/transforms/{transform_id}"
tags: ["transforms", "public"]
---

# Refresh Transform

`PATCH /v1/transforms/{transform_id}`

Refreshes an existing transform by re-running operations
on rows that need updating.

## Path parameters

- `transform_id` string, required

## Query parameters

- `asset_ids` string[] — List of asset ids to refresh. Don't provide if providing row_ids
- `row_ids` string[] — List of row ids to refresh. Don't provide if providing asset_ids
- `include_reference` boolean

## Headers

- `API-Version` string — Pass in an API version to guarantee a consistent response format. The latest version should be used for all new API calls. Existing API calls should be updated to the latest version when possible. **Valid versions:** - Latest API version (recommended): `2025-03` - Previous API version (maintenance mode): `2025-02` If no API version header is included, the response format is considered unstable and could change without notice (not recommended).

## Response `200`

Successful Response

- ReRunTransformResponse
  - `message` string, required
  - `data` ReRunTransformBaseResponse, required
    - `transform_id` string, required
    - `status` union, required
      - 'running' | 'failed' | 'completed' | 'not_started' — An enumeration.
      - 'running' | 'failed' | 'completed' | 'not_started' — An enumeration.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `408` — Request Timeout
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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