Actions16
Set Rules
AI-generatedSummary
Set access control, routing rules, variants, UTM parameters, and tracking pixels for an existing short link by specifying its ID and the desired rule changes.
Inputs
- Short Link ID (required) — The ID of the short link to update.
- Rules — A collection of optional rule sections to update, including Active From, Expires At, Fallback URL, Max Visits, Password (or Remove Password), Routing Rules, Variants, UTM parameters, Pixels, and whether pixels consent has been acknowledged.
- Version (required) — The current version number (__v) of the short link item, used for concurrency control. Use the output of a Get operation on the same link.
- Version Options — Options controlling behavior when the version number is unknown, such as failing or using the latest version.
Output shape
A single updated short link record as JSON, reflecting the changes made.
Requires that the short link ID and current version (__v) be provided. Only the specified sections in the Rules collection are changed; sections omitted remain unchanged. Empty values clear the corresponding rule. The operation enforces concurrency via the version number and fails on conflicts unless overridden in Version Options.
Examples
Example 1: Set access and routing rules on a short link
Provide the Short Link ID and specify rules like an expiration date, max visits, and routing rules in JSON. Provide the latest version number from a prior Get step to avoid conflicts.