Declares a monitored subject.

POST

/v1/m/health/checks

curl --request POST \
  --url https://example.com/v1/m/health/checks \
  --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, "subject_kind": "agent", "subject_ref": "example" }'

• this engine

Declares a monitored subject. Creating a check is a privileged write, self-audited in the same transaction.

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Olivares-Tenant

string format: uuid

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

Request Body ^required

Media type application/json

object

desired_status

Any of:

string

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

string

Allowed values: "" active paused retired

null

null

expected_interval_seconds

Any of:

integer

Values at or below zero select the server default.

integer

null

null

grace_factor

Any of:

integer

Values at or below zero select the server default.

integer

null

null

name

Any of:

string

The handler stores this value after applying its byte cap.

string

null

null

sla_target_ppm

Any of:

integer

Clamped by the handler to the inclusive range 0..1000000.

integer

null

null

subject_kind

required

string

Allowed values: agent mcp

subject_ref

required

Required exactly as decoded; the stored value is byte-capped.

string

>= 1 characters

Responses

200

OK

Media type application/json

object

Example ^generated

{}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict / setup required

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}