| 1 |
# PURPOSE |
| 2 |
Creates a signed, time-limited URL that renders a snapshot of the current Elementor content of a post without publishing it. The URL is anonymous (no WordPress login required). |
| 3 |
|
| 4 |
# WHEN TO USE |
| 5 |
**Agent self-validation only.** Call this right after a mutation (e.g. `elementor/build-composition`, `elementor/manage-elements`, `elementor/update-page-settings`) so you can fetch the returned `url` with your browser/screenshot tool and verify the change rendered as intended. |
| 6 |
|
| 7 |
# DO NOT SHARE `url` WITH THE USER |
| 8 |
The `url` field is throwaway — time-limited, frozen to a snapshot, and stops working once it expires. It is meant for your own verification loop. |
| 9 |
|
| 10 |
If the user needs a link, share the **`edit_url`** field returned by this same call. The editor link: |
| 11 |
- Stays valid across sessions. |
| 12 |
- Reflects live changes, not a frozen snapshot. |
| 13 |
- Requires the user to be logged into WordPress with edit permissions — which is the correct access model for anyone who should be looking at draft content. |
| 14 |
|