Skip to main content
PATCH
Update a template (pause/resume, caps, republish snapshot)

Authorizations

rial_session
string
cookie
required

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

slug
string
required

Template slug — lowercase [a-z0-9-].

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"warehouse-intake"

Body

application/json
status
enum<string>
Available options:
draft,
active,
paused
name
string
Required string length: 1 - 80
mode
enum<string>
Available options:
capture,
audit,
hybrid
steps
object[]
Minimum array length: 1
expires_in_seconds
integer
Required range: 60 <= x <= 86400
metadata
object
expected_location
string | null
Required string length: 1 - 300
expected_object
string | null
Required string length: 1 - 200
condition_aspects
string[] | null
Required array length: 1 - 6 elements
Required string length: 1 - 40
expected_info
object | null
daily_cap
integer | null
Required range: 1 <= x <= 10000
total_cap
integer | null
Required range: 1 <= x <= 1000000
brand_slug
string | null
Required string length: 2 - 40
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
identification
object | null
database
object | null

Response

Updated template — version reflects whether the patch touched the snapshot.

slug
string
required
name
string
required
mode
enum<string>
required
Available options:
capture,
audit,
hybrid
steps
object[]
required
expires_in_seconds
integer
required
status
enum<string>
required
Available options:
active,
paused
started_total
integer
required
started_today
integer
required
version
integer
required
Required range: x >= 1
created_at
string<date-time>
required
updated_at
string<date-time>
required
metadata
object
expected_info
object
expected_location
object
expected_object
object
condition_aspects
any[]
brand_slug
string
identification
object
database
object
daily_cap
integer
total_cap
integer