When to use it
Templates matter most when you’re working across multiple journeys that call the same endpoints. Define the shape once in the template library, then reuse it in as many steps as you need. When an endpoint changes, you update one template instead of hunting through every journey that references it. If you’re defining a new API surface, consider importing templates from an OpenAPI spec rather than creating them by hand.Key concepts
- Request template — a named, reusable definition of an HTTP request: method, URL pattern, headers, body shape, and declared values.
- Request template library — the central catalog where all templates live. Steps pull from this library when you add them to a journey.
- Template values — declarations of what data a template needs (path params, query params, headers, body fields). Journeys decide how to supply those values.
- Template assertions — assertions defined at the template level that apply whenever the template is used in a step.
- Example and Faker values — default or generated values attached to a template for previewing requests and populating test data automatically.
How it works
When you add a request step to a journey, you select a template from the library. The step inherits the template’s request shape. You then configure how each declared value is sourced — from run inputs, variables, prior step outputs, hard-coded values, secrets, or environment values. The template stays separate from the journey: the journey holds a reference to the template, not a copy. If the template is updated, every step that uses it reflects the change.Templates define structure and intent. Journeys own execution context. Keeping these separate means a single well-defined
POST /payments template can power a happy-path journey, an error-case journey, and a support runbook — all without duplicating the request definition.Related pages
Request template library
Browse and manage the central catalog of reusable templates.
HTTP request templates
The full shape of an HTTP request template.
Template values
How templates declare the values they need.
Template assertions
Assertions defined at the template level.
Import from OpenAPI
Generate templates automatically from an OpenAPI spec.
Request steps
How steps pull from templates inside a journey.

