Uptimerobot | Composio Docs

Overview

SLUG: UPTIMEROBOT

Description

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

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Uptimerobot

Create an auth config

Use the dashboard to create an auth config for the Uptimerobot toolkit. This allows you to connect multiple Uptimerobot accounts to Composio for agents to use.

Select App

Navigate to Uptimerobot.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Uptimerobot Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 uptimerobot_auth_config_id = "ac_YOUR_UPTIMEROBOT_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Uptimerobot for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, uptimerobot_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Uptimerobot toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

UPTIMEROBOT_ADD_MONITOR

Tool Name: Add Monitor

Description

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

Action Parameters

alert_contacts

friendly_name

stringRequired

http_password

http_username

interval

keyword_type

keyword_value

mwindows

port

ssl

subtype

timeout

type

integerRequired

url

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_DELETE_MONITOR

Tool Name: Delete Monitor

Description

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

Action Parameters

integerRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_EDIT_MAINTENANCE_WINDOW

Tool Name: Edit Maintenance Window

Description

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

Action Parameters

duration

integerRequired

friendly_name

integerRequired

start_time

Required

type

integerRequired

value

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_EDIT_MONITOR

Tool Name: Edit Monitor

Description

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

Action Parameters

alert_contacts

custom_http_headers

friendly_name

http_method

http_password

http_username

integerRequired

ignore_ssl

interval

keyword_type

keyword_value

maintenance_windows

port

post_type

post_value

ssl

subtype

timeout

type

up_uptime_threshold

url

verify_ssl

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_EDIT_PUBLIC_STATUS_PAGE

Tool Name: Edit Public Status Page

Description

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.

Action Parameters

custom_domain

friendly_name

hide_url_links

integerRequired

monitors

password

sort

status

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_ACCOUNT_DETAILS

Tool Name: Get Account Details

Description

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

Action Parameters

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MAINTENANCE_WINDOWS

Tool Name: Get Maintenance Windows

Description

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

Action Parameters

limit

mwindows

offset

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITOR_AUTHENTICATION_TYPE

Tool Name: Get Monitor Authentication Type

Description

Tool to get authentication type for specified monitors. Use after providing monitor IDs to check HTTP Basic Auth status.

Action Parameters

monitor_ids

arrayRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITOR_CUSTOM_HTTP_HEADERS

Tool Name: Get Monitor Custom HTTP Headers

Description

Tool to retrieve custom HTTP headers for specified monitors. Use when you need to inspect the headers set on your monitors.

Action Parameters

monitors

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITOR_CUSTOM_HTTP_STATUSES

Tool Name: Get Monitor Custom HTTP Statuses

Description

Tool to retrieve custom HTTP statuses for specified monitors. Use when you need to view user-defined up/down HTTP codes after confirming monitor IDs.

Action Parameters

monitors

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITOR_RESPONSE_TIMES

Tool Name: Get Monitor Response Times

Description

Tool to fetch historical response times for specified monitors. Use when you need performance trends over time after retrieving monitor IDs.

Action Parameters

average

limit

monitor_ids

arrayRequired

offset

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITORS

Tool Name: Get Monitors

Description

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

Action Parameters

alert_contacts

Defaults to 1

all_time_uptime_durations

custom_uptime_ranges

custom_uptime_ratios

limit

logs

Defaults to 1

monitors

offset

response_times

response_times_end_date

response_times_limit

response_times_start_date

sort

statuses

types

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITOR_SSL_CERTIFICATE_INFO

Tool Name: Get Monitor SSL Certificate Info

Description

Tool to retrieve SSL certificate information for specified monitors. Use when you need SSL details after confirming monitor IDs.

Action Parameters

monitors

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_MONITOR_TIMEZONE

Tool Name: Get Monitor Timezone

Description

Tool to retrieve timezone for specified monitors. Use after providing monitor IDs to get monitor timezones.

Action Parameters

monitor_ids

arrayRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_PUBLIC_STATUS_PAGES

Tool Name: Get Public Status Pages

Description

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

Action Parameters

limit

offset

integer

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_GET_UPTIME_RATIOS

Tool Name: Get Uptime Ratios

Description

Tool to retrieve uptime ratios for monitors. Use after obtaining monitor IDs to analyze SLA performance over custom periods.

Action Parameters

custom_uptime_ratios

stringRequired

monitors

response_times_average

response_times_end_date

response_times_start_date

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_NEW_MAINTENANCE_WINDOW

Tool Name: New Maintenance Window

Description

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

Action Parameters

day

friendly_name

stringRequired

monitors

start_time

integerRequired

type

integerRequired

value

integerRequired

Action Response

data

objectRequired

error

successful

booleanRequired

UPTIMEROBOT_NEW_PUBLIC_STATUS_PAGE

Tool Name: New Public Status Page

Description

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.

Action Parameters

custom_domains

custom_url

friendly_name

stringRequired

hide_url_links

monitors

stringRequired

password

sort

status

Action Response

data

objectRequired

error

successful

booleanRequired