---
title: "PUT /api/ee/transform/{id}"
method: PUT
path: "/api/ee/transform/{id}"
tags: ["/api/ee/transform"]
---

# PUT /api/ee/transform/{id}

`PUT /api/ee/transform/{id}`

Update a transform.

## Path parameters

- `id` integer, required

## Request body

- object
  - `collection_id` integer, nullable — value must be an integer greater than zero.
  - `description` string, nullable
  - `name` string
  - `run_trigger` 'none' | 'global-schedule'
  - `source` union
    - object
      - `query` unknown, required
      - `source-incremental-strategy` MetabaseEnterpriseTransformsSchemaSourceIncrementalStrategy
        - `checkpoint-filter` string
        - `checkpoint-filter-unique-key` string
        - `type` 'checkpoint', required
      - `type` 'query', required
    - object
      - `body` string, required
      - `source-database` integer
      - `source-incremental-strategy` MetabaseEnterpriseTransformsSchemaSourceIncrementalStrategy
        - `checkpoint-filter` string
        - `checkpoint-filter-unique-key` string
        - `type` 'checkpoint', required
      - `source-tables` object, required
      - `type` 'python', required
  - `tag_ids` integer[]
  - `target` union
    - MetabaseEnterpriseTransformsSchemaTableTarget
      - `database` integer
      - `name` string, required
      - `schema` string, nullable
      - `type` 'table', required
    - MetabaseEnterpriseTransformsSchemaTableIncrementalTarget
      - `database` integer
      - `name` string, required
      - `schema` string, nullable
      - `target-incremental-strategy` MetabaseEnterpriseTransformsSchemaTargetIncrementalStrategy, required
        - `type` 'append', required
      - `type` 'table-incremental', required

## Response `2XX`

Successful response

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

## Changes

- **2026-01-20** `bd1deee7eae2` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the `source` request property `oneOf` list
  - added `subschema #1, subschema #2` to the `source` request property `oneOf` list

[Change history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/ee/transform/:id/put.md)

---

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