Skip to main content
POST
Publish a revision as Head for this monitor

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Path Parameters

id
string<uuid>
required

Body

application/json
revisionId
string<uuid>
required

Revision to make live for this monitor's environment

expectedLiveRevisionId
string<uuid> | null

Live revision this publish replaces; null skips the check

requireTested
boolean | null

When true, require a passing test in this environment within 24 hours

force
boolean | null

Skip the requireTested check; needs the publish-untested scope

acknowledgeRollback
string | null

Rolled-back digest this publish re-applies on purpose

note
string | null

Optional note describing this publish

Maximum string length: 280

Response

OK

data
object
required

Active Head for a definition in one environment