> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/spark-apis/transforms-api/transform-documents.md).

# Transform documents

{% hint style="warning" %}
This feature is only enabled on certain environments and tenants. Please contact [Support](/support/support.md) for more information about this feature.
{% endhint %}

Transform documents contain the instructions on how to translate requests and responses to be compatible with the Spark [Execute API](/spark-apis/execute-api.md).

## Create new transform documents

1. Transform files should be saved as `JSON` files with filenames ending with `_transform.json`.
2. Navigate into the [Folder overview](/navigation/folder-overview.md) page for your target destination folder.
3. Choose the *Transforms* tab.
4. Click **New Transform**.
   1. You can upload a pre-defined transform document. This must conform to the specifications in [#define-transform-document](#define-transform-document "mention") and to any specific requirements for the transform being used.
   2. Create a new transform within Spark. From the UX you have the ability to choose the *Transform type*, *Target API version* and provide the code for the request and response transforms.

This new method replaces the previous approach of using [Options](/navigation/options.md) [Options](/navigation/options.md#files) to save transforms to `apps/transforms`.

## Manage transform documents

Transforms can be managed from the [Folder overview](/navigation/folder-overview.md) page in the *Transforms* tab. You can add, update, edit, and delete transforms through the user interface.

This can also be done using [Transform documents APIs](/spark-apis/transforms-api/transform-documents-apis.md).

## Define transform document

Transform documents will vary depending on the [Transform types](/spark-apis/transforms-api/transform-types.md) being used.
