Skip to content

Patches a check's configuration.

PUT
/v1/m/health/checks/{id}
curl --request PUT \
--url https://example.com/v1/m/health/checks/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "desired_status": "", "expected_interval_seconds": 1, "grace_factor": 1, "name": "example", "sla_target_ppm": 1 }'

Patches a check’s configuration. Privileged write, self-audited.

id
required
string

Path parameter id.

X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Media type application/json
object
desired_status
Any of:

Empty keeps/defaults the lifecycle state; non-empty values are validated exactly.

string
Allowed values: "" active paused retired
expected_interval_seconds
Any of:

Only positive values replace the stored interval.

integer
grace_factor
Any of:

Only positive values replace the stored grace factor.

integer
name
Any of:

Empty keeps the stored name; non-empty values are byte-capped.

string
sla_target_ppm
Any of:

A number is clamped to 0..1000000; omitted or null keeps the stored target.

integer

OK

Media type application/json
object
Example generated
{}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict / setup required

Media type application/json
object
Example generated
{}

Rate limited

Media type application/json
object
Example generated
{}