/service/@id/uptime/monitors/@monitorUpdate a monitor
Send only the fields to change, as a JSON body. settings carries every required field of its type; for http, keyword: omit headers, body, basic_auth to keep them, headers: {} or body: "" to remove, clear_basic_auth: true to remove Basic auth. enabled: false turns the monitor off.
A Tino Uptime service route: call it with the service owner's sign-in token; the /v1 gateway (app tokens, personal tokens) does not expose Tino Uptime yet. See Getting started with Tino Uptime.
Authentication
Send the token in the header Authorization:
Authorization: Bearer <token>
Tokens that can call it: the Tino Uptime service owner's sign-in token (the tino.vn client area token).
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | int | Required | Tino Uptime service ID |
monitor | string | Required | Monitor ID (UUID, `id` in the monitor list) |
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Optional | Monitor name, 1–200 characters |
interval_s | int | Optional | Check interval in seconds, 30–86400, not below the plan's `limits.min_interval_s` |
locations | array | Optional | Probe locations, up to 10, within the plan's `limits.locations` (`vn-cmc`, `vn-vt`, `intl`) |
enabled | boolean | Optional | `false` turns the monitor off (settings kept), `true` turns it back on |
settings | object | Optional | Check type and target: `type` is `http`, `keyword`, `ssl`, `domain`, `ping`, `tcp`, `dns` or `heartbeat`, fields per type in [Getting started with Tino Uptime](/en/docs/uptime-start#monitor-types) |
international_critical | boolean | Optional | `true`: a failure seen only by the international probe also counts as down; default `false` |
Response
Sample built from the Tino Uptime OpenAPI (Tino relays the answer as is inside data); values are examples.
Error codes
| Error code | Description |
|---|---|
404 · service_not_found, invalid method | The service does not belong to the signed-in account, or is not Tino Uptime. |
404 · service_not_linked | The service is no longer the customer's current Tino Uptime plan. |
403 · account_suspended | The Tino Uptime account is suspended: writes are blocked, GET still works. |
403 · entitlement_exceeded | Over a plan limit; details.resource names the limit. |
422 · validation_failed | Invalid data; details.field names the field. |
502 · network, invalid_response | The connection between Tino and Tino Uptime is interrupted: a Tino-side error, not a token problem. Retry later. |
Errors look like {"error": ["<CODE>"], "message", "details", "request_id"}; every code is in Getting started with Tino Uptime.