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

# POST /api/ee/workspace/{ws-id}/transform

`POST /api/ee/workspace/{ws-id}/transform`

Add another transform to the Changeset. This could be a fork of an existing global transform, or something new.

## Path parameters

- `ws-id` integer, required — value must be an integer greater than zero.

## Request body

- object
  - `description` string, nullable
  - `name` string, required
  - `source` union, required
    - object
      - `query` unknown, required
      - `type` 'query', required
    - object
      - `body` string, required
      - `source-database` integer
      - `source-tables` object[], required
        - `alias` string, required
        - `table_id` integer, required
      - `type` 'python', required

## Response `2XX`

Successful response

- object
  - `archived_at` unknown, required
  - `created_at` unknown, required
  - `creator_id` integer, required — value must be an integer greater than zero.
  - `description` string, nullable, required
  - `global_id` integer, required — value must be an integer greater than zero.
  - `last_run_at` unknown, required
  - `last_run_message` string, nullable, required
  - `last_run_status` string, nullable, required
  - `name` string, required
  - `ref_id` string, required
  - `source` object, required
  - `target` object, required
  - `target_stale` boolean, nullable, required
  - `updated_at` unknown, required
  - `workspace_id` integer, required — value must be an integer greater than zero.

## Other responses

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

## Changes

- **2026-03-09** `78297d193ca4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/ee/workspace/:ws-id/transform/post.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/78297d193ca4/schema)