Update a template (pause/resume, caps, republish snapshot)
Templates
Update a template (pause/resume, caps, republish snapshot)
Partial update. Two classes of field behave differently (GET-83):
- Snapshot fields (
mode,steps,expires_in_seconds,metadata,expected_info,brand_slug,database) — touching any of them bumpsversion. - Operational fields (
status,daily_cap,total_cap,name) — version stays put; pausing a link is not a new snapshot.
steps sent without mode is validated against the PERSISTED mode.
PATCH
Update a template (pause/resume, caps, republish snapshot)
Authorizations
Dashboard / operator session cookie. Set by /v1/auth/google/callback after Google OAuth, JWT signed with the rotating rial-platform/session-signing HMAC. Read on every request the SPA makes with credentials: include. Browser-only — server-to-server callers use bearerApiKey instead.
Path Parameters
Template slug — lowercase [a-z0-9-].
Pattern:
^[a-z0-9]+(?:-[a-z0-9]+)*$Example:
"warehouse-intake"
Body
application/json
Available options:
draft, active, paused Required string length:
1 - 80Available options:
capture, audit, hybrid Minimum array length:
1- Option 1
- Option 2
- Option 3
Required range:
60 <= x <= 86400Required string length:
1 - 300Required string length:
1 - 200Required array length:
1 - 6 elementsRequired string length:
1 - 40Required range:
1 <= x <= 10000Required range:
1 <= x <= 1000000Required string length:
2 - 40Pattern:
^[a-z0-9]+(?:-[a-z0-9]+)*$Response
Updated template — version reflects whether the patch touched the snapshot.
Available options:
capture, audit, hybrid Available options:
active, paused Required range:
x >= 1