# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coherent.global/spark-apis/transforms-api/transform-documents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.