コンテンツにスキップ
Manako ドキュメント

モニター作成

POST
/api/v1/monitors

新しいモニターを作成する。write スコープが必要。 プラン上限 (モニター数・最小チェック間隔) を超える場合は 402 エラー。

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
type
required
string
Allowed values: http tcp ping heartbeat webchange ssl domain host_agent
name

通知やステータスページで表示される名前。省略時はconfigから自動生成されます。

string
<= 100 characters
config
required

モニタータイプごとの設定。 webchange の場合: { url, selector?, checkType, changeMode? }

  • changeMode: “tamper” (変更検知後ダウン状態を維持、デフォルト) または “track” (変更を記録しアップ状態を維持)
object
intervalSeconds
integer
default: 300 >= 60 <= 86400
serviceId

割り当てるステータスページの ID。省略時はチームのデフォルトステータスページに割り当てられます。

string

Responses

Section titled “ Responses ”

201

Section titled “201 ”

モニター作成成功 (host_agentタイプの場合は agentToken も返却される)

object
monitor
object
id
string
teamId
string
type
string
Allowed values: http tcp ping heartbeat webchange ssl domain host_agent
name
string
config

Type-specific configuration

object
intervalSeconds
integer
>= 60 <= 86400
status
string
Allowed values: up down degraded unknown paused
isActive
integer
Allowed values: 0 1
lastCheckedAt
string format: date-time
nullable
initializedAt

ISO 8601 timestamp of the first successful “up” check. Null while the monitor is in the initial grace period (incidents suppressed).

string format: date-time
nullable
maintenanceUntil

ISO 8601 timestamp until which the monitor is under maintenance. Null when not in maintenance.

string format: date-time
nullable
autoResolveMaintenance

Whether maintenance auto-resolves (1) or requires manual resolution (0).

integer
Allowed values: 0 1
createdAt
string format: date-time
updatedAt
string format: date-time
agentToken

Host_agentタイプの場合のみ返却。メトリクス送信用トークン (64文字hex)。このトークンは一度しか返却されません。

string
Example
a1b2c3d4e5f6...

400

Section titled “400 ”

バリデーションエラー

object
error
object
code
string
Example
VALIDATION_ERROR
message
string
Example
Invalid request body
status
integer
Example
400
upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string
Example
https://app.manako.dev/billing

402

Section titled “402 ”

プラン上限超過

object
error
object
code
string
Example
VALIDATION_ERROR
message
string
Example
Invalid request body
status
integer
Example
400
upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string
Example
https://app.manako.dev/billing