| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Overview
The FormTagExpression endpoint evaluates dynamic merge tags (template expressions) against specific records in Origami. {FormTags} are often used throughout Origami in document generation, form filling, data transformations, and custom reporting where you need to extract, format, or calculate values from a record.
Think of this as a "mail merge" system similar to Microsoft Word's merge fields, but accessible via API. You provide a template expression like Incident.Claimant-FirstName and get back the actual value from the specified record (e.g., "John").
The endpoint evaluates your tag expression and returns the processed result - either a simple value (string, number, date) or a complex calculated result. The response format is JSON containing the resolved value.
The tagExpression parameter accepts one tag expression at a time and returns the single evaluated result. If you need to evaluate multiple independent tags (like getting both first name and last name), you would need to make separate API calls:
However, that single expression can be quite flexible as it is capable of applying business logic.
So while you can only evaluate one expression per API call, that expression can internally reference multiple fields, perform calculations, or use fallback logic.
For an in-depth review, please see the following supplemental guide.