# Uptimerobot

UptimeRobot is a service that monitors the uptime and performance of websites, applications, and services, providing real-time alerts and detailed logs.

- **Category:** server monitoring
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 17
- **Triggers:** 0
- **Slug:** `UPTIMEROBOT`
- **Version:** 20260312_00

## Tools

### Add Monitor

**Slug:** `UPTIMEROBOT_ADD_MONITOR`

Tool to create a new monitor. Use when you need to start monitoring a URL or service; call after obtaining a valid API key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ssl` | integer | No | Enable SSL validation: 1=yes, 0=no |
| `url` | string | Yes | URL or IP address to monitor |
| `port` | integer | No | Port number for custom port monitors (subtype=99) |
| `type` | integer | Yes | Type of monitor: 1=HTTP(s), 2=Keyword, 3=Ping, 4=Port |
| `subtype` | integer | No | Port-monitor subtype if type=4: 1=HTTP,2=HTTPS,3=FTP,4=SMTP,5=POP3,6=IMAP,99=Custom |
| `timeout` | integer | No | Request timeout in seconds (1-60, default=30) |
| `interval` | integer | No | Monitoring interval in minutes (min 30 for free plan, default varies by plan) |
| `mwindows` | string | No | Comma-separated maintenance window IDs |
| `keyword_type` | integer | No | For keyword monitors (type=2): 1=exists,2=not exists |
| `friendly_name` | string | Yes | User-friendly name for the monitor |
| `http_password` | string | No | Password for HTTP authentication |
| `http_username` | string | No | Username for HTTP authentication |
| `keyword_value` | string | No | Keyword to monitor on the page for type=2 |
| `alert_contacts` | string | No | Comma-separated IDs of alert contacts |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Monitor

**Slug:** `UPTIMEROBOT_DELETE_MONITOR`

Tool to delete a monitor. Use when you need to remove an existing monitor by its ID; use after confirming the monitor ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The ID of the monitor to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Maintenance Window

**Slug:** `UPTIMEROBOT_EDIT_MAINTENANCE_WINDOW`

Tool to edit an existing maintenance window. Use when you need to update its name, timing, recurrence, or duration after confirming the window ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the maintenance window to edit. |
| `type` | integer ("1" | "2" | "3") | Yes | Type of maintenance window: 1=once, 2=daily, 3=weekly. |
| `value` | string | No | Comma-separated day numbers for daily (2) or weekly (3); not needed for once (1). |
| `duration` | integer | Yes | Duration of the maintenance window in minutes. |
| `start_time` | string | Yes | Start time: 'YYYY-MM-DD HH:mm:ss' for once, 'HH:mm' for recurring or Unix timestamp in seconds. |
| `friendly_name` | string | No | A friendly name for the maintenance window. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Monitor

**Slug:** `UPTIMEROBOT_EDIT_MONITOR`

Tool to edit an existing monitor. Use after confirming the monitor ID exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the monitor to be edited (required) |
| `ssl` | integer | No | Enable SSL notifications: 1=Yes,0=No |
| `url` | string | No | New URL to be monitored |
| `port` | integer | No | Port number for type=4 monitors |
| `type` | integer | No | Monitor type: 1=HTTP(s),2=Keyword,3=Ping,4=Port,5=Heartbeat,6=SSL |
| `subtype` | integer | No | Subtype for port monitoring if type=4 |
| `timeout` | integer | No | Timeout in seconds before a check is considered failed |
| `interval` | integer | No | Monitoring interval in minutes |
| `post_type` | integer | No | POST data type: 1=Raw,2=URL-encoded |
| `ignore_ssl` | integer | No | Ignore SSL errors: 1=Yes,0=No |
| `post_value` | string | No | POST data payload content |
| `verify_ssl` | integer | No | Verify SSL certificate: 1=Yes,0=No |
| `http_method` | string | No | HTTP method to use for monitor checks |
| `keyword_type` | integer | No | Keyword check type: 1=Exists,2=Not Exists |
| `friendly_name` | string | No | New friendly name for the monitor |
| `http_password` | string | No | Password for HTTP authentication |
| `http_username` | string | No | Username for HTTP authentication |
| `keyword_value` | string | No | Keyword value to check in keyword monitors |
| `alert_contacts` | string | No | Comma-separated alert contact IDs |
| `custom_http_headers` | object | No | Custom HTTP headers as a dict; will be JSON-encoded |
| `maintenance_windows` | string | No | Comma-separated maintenance window IDs |
| `up_uptime_threshold` | integer | No | Uptime threshold percentage (0-100) for 'UP' status |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Public Status Page

**Slug:** `UPTIMEROBOT_EDIT_PUBLIC_STATUS_PAGE`

Tool to edit an existing public status page. Use after confirming the page ID. Updates friendly name, monitor set, domain, and status options in one call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique integer ID of the public status page to edit. |
| `sort` | integer ("1" | "2" | "3" | "4") | No | Order in which monitors appear: 1=A–Z, 2=Z–A, 3=Up–Down–Paused, 4=Down–Up–Paused. |
| `status` | integer ("0" | "1") | No | 0=Paused, 1=Active. Use to enable or disable the public page. |
| `monitors` | string | No | Dash-separated list of monitor IDs to include on the page, e.g. '123-456-789'. Use '0' to include all monitors. |
| `password` | string | No | Password to protect the status page (if enabled). |
| `custom_domain` | string | No | Custom domain or subdomain where the status page will be hosted. |
| `friendly_name` | string | No | New friendly name for the status page. Leave blank to keep current name. |
| `hide_url_links` | boolean | No | If true, removes the UptimeRobot link from the status page (Pro plan only). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Details

**Slug:** `UPTIMEROBOT_GET_ACCOUNT_DETAILS`

Tool to retrieve account details. Use after authenticating with a valid API key to fetch account metrics.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Alert Contacts

**Slug:** `UPTIMEROBOT_GET_ALERT_CONTACTS`

Tool to retrieve all alert contacts configured for the account. Use when you need to list available notification channels.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Maintenance Window

**Slug:** `UPTIMEROBOT_GET_MAINTENANCE_WINDOW`

Tool to retrieve a specific maintenance window by ID. Use when you need to get detailed information about a single maintenance window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the maintenance window to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Maintenance Windows

**Slug:** `UPTIMEROBOT_GET_MAINTENANCE_WINDOWS`

Tool to retrieve maintenance windows. Use after confirming a valid API key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of records to return (default: 50, max: 50). |
| `offset` | integer | No | Pagination offset; record to start returning from (default: 0). |
| `mwindows` | string | No | Hyphen-separated list of maintenance window IDs to retrieve (e.g., '12345-67890'); if omitted, returns all windows. Single ID can also be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Monitors

**Slug:** `UPTIMEROBOT_GET_MONITORS`

Tool to fetch monitor details and status. Use after confirming account connection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `logs` | integer | No | 1 to include up to 21 log entries, 0 to omit. |
| `sort` | string ("friendly_name" | "url" | "status" | "type") | No | Field by which to sort results. |
| `limit` | integer | No | Maximum number of monitors to return (max 50). |
| `types` | string | No | Hyphen-separated monitor type codes, e.g. '1-2'. |
| `offset` | integer | No | Zero-based pagination offset. |
| `search` | string | No | Search term for friendly_name, URL, or type. |
| `monitors` | string | No | Hyphen-separated monitor IDs to retrieve, e.g. '1234-5678'. |
| `statuses` | string | No | Hyphen-separated monitor status codes, e.g. '2-8'. |
| `alert_contacts` | integer | No | 1 to include alert contact details, 0 to omit. |
| `response_times` | integer | No | 1 to include response time data, 0 to omit. |
| `custom_uptime_ranges` | string | No | Hyphen-separated date ranges (YYYY-MM-DD_YYYY-MM-DD), e.g. '2023-01-01_2023-01-07'. |
| `custom_uptime_ratios` | string | No | Hyphen-separated days for custom uptime ratios, e.g. '7-30-45'. |
| `response_times_limit` | integer | No | Maximum number of response time records per monitor. |
| `response_times_end_date` | integer | No | UNIX timestamp (seconds) to end response time data. |
| `all_time_uptime_durations` | string | No | Hyphen-separated day intervals for total uptime durations, e.g. '30-60-90'. |
| `response_times_start_date` | integer | No | UNIX timestamp (seconds) to start response time data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Status Pages

**Slug:** `UPTIMEROBOT_GET_PUBLIC_STATUS_PAGES`

Tool to retrieve public status pages. Use after confirming API credentials to list all public status pages for an account. Supports pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of public status pages to return (1-50) |
| `offset` | integer | No | Pagination start offset; must be non-negative |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Integrations

**Slug:** `UPTIMEROBOT_LIST_INTEGRATIONS`

Tool to list all integrations. Use to retrieve configured integrations for the account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | integer | No | Cursor to paginate through the integrations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Status Pages (v3)

**Slug:** `UPTIMEROBOT_LIST_PSPS`

Tool to list public status pages using the v3 API. Use to retrieve all PSPs with cursor-based pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | integer | No | Cursor to paginate through PSPs. Omit for first page, then use the cursor from the response to fetch subsequent pages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### New Maintenance Window

**Slug:** `UPTIMEROBOT_NEW_MAINTENANCE_WINDOW`

Tool to create a new maintenance window. Use after confirming window parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `day` | integer | No | Day of the week for weekly windows (1=Monday to 7=Sunday); required if type=3. |
| `type` | integer ("1" | "2" | "3") | Yes | Type of maintenance window: 1=once, 2=daily, 3=weekly. |
| `value` | integer | Yes | Duration of the maintenance window in minutes. |
| `monitors` | string | No | Comma-separated monitor IDs to apply the window to; if omitted, applies to all monitors. |
| `start_time` | integer | Yes | Start time as Unix timestamp in seconds. |
| `friendly_name` | string | Yes | User-friendly name for the maintenance window. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### New Public Status Page

**Slug:** `UPTIMEROBOT_NEW_PUBLIC_STATUS_PAGE`

Tool to create a new public status page. Use when you want to publish a public status page for selected monitors after specifying a friendly name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | integer | No | Sorting mode: 0=no sorting, 1=by status, 2=custom order |
| `status` | integer | No | Page status: 0=paused, 1=active |
| `monitors` | string | Yes | Comma-separated IDs of monitors to display, or '*' for all monitors |
| `password` | string | No | Password for viewing the status page |
| `custom_url` | string | No | Custom URL slug for the status page |
| `friendly_name` | string | Yes | User-assigned friendly name for the status page |
| `custom_domains` | string | No | Comma-separated custom domains for the status page |
| `hide_url_links` | integer | No | Hide monitor URL links: 1=yes, 0=no |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |