Skip to main content

Transforms

The Transforms page lets you create and manage named, reusable JSONata transform expressions for your project.

What Are Transforms?​

A Transform is a saved JSONata expression with a name. Once created, a transform can be assigned to any number of endpoint-destination links in your project. This lets you define payload reshaping logic once and reuse it across multiple links without duplicating the expression.

For the conceptual overview of how transforms work, see Payload Transforms.

Creating a Transform​

  1. Navigate to Transforms → Create Transform
  2. Enter a name (e.g., "Extract PR fields")
  3. The editor opens with an empty expression and a live preview panel

Transform Editor​

The editor has two panels:

  • Left: Expression Editor — write your JSONata expression with syntax highlighting and validation
  • Right: Live Preview — paste a sample payload and see the transform output in real time

Expression Editor​

Type your JSONata expression directly. Syntax errors are highlighted inline. Example:

{
  "action": action,
  "repo": repository.full_name,
  "sender": sender.login,
  "pr_title": pull_request.title,
  "pr_url": pull_request.html_url
}

Live Preview​

Paste a JSON payload into the input field and the preview pane shows the transformed output. This lets you verify your expression before saving and assigning it to a link.

AI JSONata Generator​

The transform editor includes an AI-powered expression generator. Click the Generate with AI button (or press Ctrl+Alt+P), describe what you want in plain English, and Dispatch produces a JSONata expression for you.

For example: "Extract the PR title, author login, and repository name into a flat object."

The generated expression is applied to the editor automatically. Review it in the live preview before saving.

Managing Transforms​

From the Transforms list page you can:

  • Rename a transform by clicking the name inline
  • Edit the expression by opening the transform editor
  • Delete a transform (this removes the reference from any links using it — the link will fall back to no transform)

After creating a transform, assign it to one or more endpoint-destination links:

  1. Go to Sources
  2. Expand the endpoint and click Edit on the destination link
  3. Under Transform, select the named transform from the dropdown
  4. Save the link

To remove a transform from a link, open the link editor and clear the transform selection.

Routing Rule Overrides​

Individual routing rules on a link can specify a different transform_id, allowing you to use a completely different transform for specific event types without changing the link's default.