Pingdom | Composio Docs

Overview

SLUG: PINGDOM

Description

Template description for Pingdom

Authentication Details

API Key

api_key

stringRequired

Connecting to Pingdom

Create an auth config

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

Select App

Navigate to Pingdom.

Configure Auth Config Settings

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

Create and Get auth config ID

Click “Create Pingdom 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 pingdom_auth_config_id = "ac_YOUR_PINGDOM_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 Pingdom 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, pingdom_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 Pingdom toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["PINGDOM"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

PINGDOM_GET_ACTIONS_ALERTS

Tool Name: Get Pingdom Alert Actions

Description

Tool to retrieve a list of alert actions for your pingdom account. use when you need to fetch actions with optional filters: pagination, check ids, user ids, status, via channel, or time range.

Action Parameters

checkids

array

endtime

integer

limit

integer

start

integer

starttime

integer

status

array

userids

array

via

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_CHECKS_LIST

Tool Name: Get Checks List

Description

Tool to retrieve an overview list of all uptime checks with optional filters and pagination. use when you need to fetch checks after configuring probes or tags.

Action Parameters

include_tags

boolean

integrationids

string

limit

integer

name

string

offset

integer

probeids

string

status

string

PINGDOM_GET_CONTACTS

Tool Name: Get Contacts

Description

Tool to retrieve all alerting contacts. use when you need to list every contact along with their notification targets after establishing a pingdom session.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_CONTACT_DETAILS

Tool Name: Get Contact Details

Description

Tool to fetch detailed info of a specific pingdom alerting contact. use when you need full configuration of a contact’s notification methods by contact id.

Action Parameters

contactid

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_CREDITS

Tool Name: Get Credits

Description

Tool to retrieve account credit and rate-limit information. use when you need to check remaining checks and api credits before proceeding with further requests.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_LIST_MAINTENANCE_OCCURRENCES

Tool Name: List Maintenance Occurrences

Description

Tool to list maintenance occurrences. use when you need occurrences filtered by time range or a specific maintenance window id.

Action Parameters

from_time

integer

limit

integer

maintenancewindowid

integer

offset

integer

to_time

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_MAINTENANCE_WINDOWS

Tool Name: Get Maintenance Windows

Description

Tool to retrieve a list of maintenance windows. use when you need to list user's maintenance windows with optional pagination and time range filters.

Action Parameters

from_time

integer

limit

integer

offset

integer

to_time

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_PROBES

Tool Name: Get Probes

Description

Tool to retrieve all pingdom probe servers. use when you need to list available probes for uptime or transaction checks.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_REFERENCE_DATA

Tool Name: Get Reference Data

Description

Tool to retrieve pingdom reference data including time zones, states, probes, actions, roles, contact types, and integration types. use when you need account-wide reference lists before configuring checks.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_SINGLE_CHECK

Tool Name: Get Single Check

Description

Tool to perform a single pingdom check. use when you need an immediate test of a host or url from specific probes. example: "perform single check on example.com with http type".

Action Parameters

host

stringRequired

port

integer

probeids

array

type

stringRequired

url

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_TEAMS

Tool Name: Get Teams

Description

Tool to retrieve all alerting teams and their members. use after authenticating to pingdom to manage team configurations.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_TEAM_DETAILS

Tool Name: Get Team Details

Description

Tool to fetch detailed information for a specific alerting team. use after listing teams to get full members and integrations details.

Action Parameters

teamid

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

PINGDOM_GET_TMS_TRANSACTION_CHECKS_LIST

Tool Name: Get TMS Transaction Checks List

Description

Tool to list all transaction (tms) checks. use when you need an overview of all scripted or recorded checks.

Action Parameters

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired