Skip to main content
POST
Transfer a monitor to another owning tool

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
to
enum<string>
required

New owning tool: DASHBOARD, GIT, TERRAFORM, MCP or API (CLI = GIT until 2027-01-31)

Available options:
DASHBOARD,
CLI,
TERRAFORM,
MCP,
API,
GIT
reason
string
required

Why ownership is moving (recorded in the audit log)

Maximum string length: 280
project
string | null

Project the new owner declares for this monitor; null clears it

Maximum string length: 255
ownerDeclaration
object | null

Advisory location and label declared by the owner

Response

OK

data
object
required

Full monitor representation