---
swagger: "2.0"
x-collection-name: Apica
x-complete: 0
info:
title: Scenarios API Scenarios Proxy Sniffer Dictionaries
version: 1.0.0
description: Updates Proxy Sniffer scenario custom dictionary.
host: api.pingdom.com
schemes:
- http
produces:
- application/json
consumes:
- application/json
paths:
? '/alerts?check_id={check_id}&severity={severity}&enabled={enabled}&target_type={target_type}&target_id={target_id} '
: ' get ':
summary: Alerts
description: Gets alerts filtered by set of optional parameters.
operationId: -alertscheck-idcheck-idampseverityseverityampenabledenabledamptarget-typetarget-typeamptarget-idtarg
x-api-path-slug: alertscheck-idcheck-idampseverityseverityampenabledenabledamptarget-typetarget-typeamptarget-idtarget-id-get
responses:
200:
description: OK
tags:
- Alerts
'/alerts/{alert_id} ':
' get ':
summary: Alerts
description: Gets alert by Id.
operationId: -alerts-alert-id-
x-api-path-slug: alertsalert-id-get
responses:
200:
description: OK
tags:
- Alerts
' put ':
summary: Alerts
description: Updates alert.
operationId: -alerts-alert-id-
x-api-path-slug: alertsalert-id-put
responses:
200:
description: OK
tags:
- Alerts
' delete ':
summary: Alerts
description: Deletes alert by Id.
operationId: -alerts-alert-id-
x-api-path-slug: alertsalert-id-delete
responses:
200:
description: OK
tags:
- Alerts
'/alerts/{alert_type} ':
' post ':
summary: Alerts
description: Creates a new alert.
operationId: -alerts-alert-type-
x-api-path-slug: alertsalert-type-post
responses:
200:
description: OK
tags:
- Alerts
'/alerts/recipients ':
' get ':
summary: Alerts Recipients
description: Gets a list of all alert recipient's targets that are visible to
you as a customer.
operationId: -alerts-recipients-
x-api-path-slug: alertsrecipients-get
responses:
200:
description: OK
tags:
- Alerts
'/alerts/recipients/{recipient_id} ':
' get ':
summary: Alerts Recipients
description: Gets a information about alert recipient's targets.
operationId: -alerts-recipients-recipient-id-
x-api-path-slug: alertsrecipientsrecipient-id-get
responses:
200:
description: OK
tags:
- Alerts
'/alerts/recipient/{recipient_id} ':
' put ':
summary: Alerts Recipient
description: Updates recipient along with sms and email targets associated.
operationId: -alerts-recipient-recipient-id-
x-api-path-slug: alertsrecipientrecipient-id-put
responses:
200:
description: OK
tags:
- Alerts
'/alerts/recipient ':
' post ':
summary: Alerts Recipient
description: Creates a new recipient with one sms and one email target associated.
operationId: -alerts-recipient-
x-api-path-slug: alertsrecipient-post
responses:
200:
description: OK
tags:
- Alerts
'/alerts/targets ':
' get ':
summary: Alerts Targets
description: Gets a list of all alert targets that are visible to you as a customer.
operationId: -alerts-targets-
x-api-path-slug: alertstargets-get
responses:
200:
description: OK
tags:
- Alerts
/alerts/configs/alertId:
delete:
summary: Deleting an alert
description: Deleting an alert
operationId: deleting-an-alert
x-api-path-slug: alertsconfigsalertid-delete
parameters:
- in: path
name: alertId
description: The ID of the alert to be deleted
type: string
- in: path
name: token
description: Your API token
type: string
- in: body
name: token
description: Your API token
schema:
$ref: '#/definitions/holder'
- in: query
name: token
description: Your API token
type: string
responses:
200:
description: OK
tags:
- Alerts
/alerts/configs/subjectId:
get:
summary: Listing alerts by subject
description: Get a list of all configured alerts for a specific subject (device
or service).
operationId: listing-alerts-by-subject
x-api-path-slug: alertsconfigssubjectid-get
parameters:
- in: path
name: subjectId
description: The ID of the subject e
type: string
- in: path
name: subjectType
description: The type of the subject - device or service
type: string
- in: query
name: subjectType
description: The type of the subject - device or service
type: string
- in: path
name: token
description: Your API token
type: string
- in: query
name: token
description: Your API token
type: string
responses:
200:
description: OK
tags:
- Alerts
/alerts/triggered:
get:
summary: Triggered Alerts
description: Get a list of all triggered alerts on your account, per subject
(device or service) or per alert config.
operationId: triggered-alerts
x-api-path-slug: alertstriggered-get
parameters:
- in: query
name: closed
description: Whether to filter by closed or open alerts - unset = all alerts,
false = open alerts, true = closed alerts
type: string
- in: query
name: filter
description: You can provide a JSON encoded hash filter for the search that
will return items that match the filter
type: string
- in: query
name: subjectType
description: The type of the subject - device, service, deviceGroup or serviceGroup
if you also specify the subjectId as part of the URL (see examples below)
type: string
- in: query
name: token
description: Your API token
type: string
responses:
200:
description: OK
tags:
- Alerts
'/checks/browser ':
' post ':
summary: Checks Browser
description: Creates a new browser check.
operationId: -checks-browser-
x-api-path-slug: checksbrowser-post
responses:
200:
description: OK
tags:
- Browser
'/checks/browser/{checkId} ':
' put ':
summary: Checks Browser
description: Updates a browser check.
operationId: -checks-browser-checkid-
x-api-path-slug: checksbrowsercheckid-put
responses:
200:
description: OK
tags:
- Browser
'/checks/browser/locations ':
' get ':
summary: Checks Browser Locations
description: Gets a list of all locations that are available for browser checks.
operationId: -checks-browser-locations-
x-api-path-slug: checksbrowserlocations-get
responses:
200:
description: OK
tags:
- Browser
/checks/browser/{checkId}/results/{resultId}/urldata:
' get ':
summary: Checks Browser Results
description: Gets a file that contains browser check result data.
operationId: -checks-browser-checkid-results-resultid-urldataformatformat-
x-api-path-slug: checksbrowsercheckidresultsresultidurldata-get
responses:
200:
description: OK
tags:
- Browser
'/checks/browser/{checkId}/results/urldata ':
' post ':
summary: Checks Browser Results
description: Gets browser check results in json format by result ids.
operationId: -checks-browser-checkid-results-urldata-
x-api-path-slug: checksbrowsercheckidresultsurldata-post
responses:
200:
description: OK
tags:
- Browser
'/checks ':
' get ':
summary: Get Checks
description: Gets a list of all checks that are visible to you as a user or
a customer depending on the request context.
operationId: getChecks
x-api-path-slug: checks-get
responses:
200:
description: OK
tags:
- Checks
'/checks/{checkId} ':
' get ':
summary: Get Check
description: Gets info about a check, current SLA, last result and its status.
operationId: getChecksCheck
x-api-path-slug: checkscheckid-get
responses:
200:
description: OK
tags:
- Checks
' put ':
summary: Update Check
description: Updates a check.
operationId: putChecksCheck
x-api-path-slug: checkscheckid-put
responses:
200:
description: OK
tags:
- Checks
' delete ':
summary: Delete Check
description: Deletes a check.
operationId: deleteChecksCheck
x-api-path-slug: checkscheckid-delete
responses:
200:
description: OK
tags:
- Checks
'/checks/{checkId}/lastvalue ':
' get ':
summary: Get Checks Lastvalue
description: Gets the absolute last value of a specific check.
operationId: getChecksCheckLastvalue
x-api-path-slug: checkscheckidlastvalue-get
responses:
200:
description: OK
tags:
- Checks
/checks/{checkId}/results/{millisecondsUtc}:
' get ':
summary: Get Checks Results
description: Gets a specific check result by a numeric java timestamp.
operationId: getChecksCheckResultsMillisecondsutcDetailLevelDetailLevel
x-api-path-slug: checkscheckidresultsmillisecondsutc-get
responses:
200:
description: OK
tags:
- Checks
/checks/{checkId}/results:
' get ':
summary: Get Checks Results
description: Gets the most recent check results.
operationId: getChecksCheckResultsMostrecentMostrecent&detailLevelDetailLevel
x-api-path-slug: checkscheckidresults-get
responses:
200:
description: OK
tags:
- Checks
? |2-
/api/{version}/checks
: ? |2-
get
: summary: Get Check List
description: Returns a list overview of all checks.
operationId: |2-
getApiVersionChecks
x-api-path-slug: apiversionchecks-get
parameters:
- in: query
name: include_tags
description: Include tag list for each check
type:
boolean |
- in: query
name: limit
description: Limits the number of returned probes to the specified quantity
type: integer |
- in: query
name: offset
description: Offset for listing
type: integer |
- in: query
name: tags
description: Tag list separated by commas
type: string |
responses:
200:
description: OK
tags:
- Checks
'/checks/command ':
' post ':
summary: Checks Command
description: Creates a new Command check.
operationId: -checks-command-
x-api-path-slug: checkscommand-post
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/command-v2 ':
' post ':
summary: Checks Command
description: Creates a new Command check (version 2).
operationId: -checks-command-v2-
x-api-path-slug: checkscommandv2-post
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/command-v2/{checkId} ':
' put ':
summary: Checks Command
description: Updates a command check (version 2).
operationId: -checks-command-v2-checkid-
x-api-path-slug: checkscommandv2checkid-put
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/command/{checkId} ':
' put ':
summary: Checks Command
description: Updates a command check.
operationId: -checks-command-checkid-
x-api-path-slug: checkscommandcheckid-put
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/command/categories ':
' get ':
summary: Checks Command Categories
description: Gets a list of all command check categories that are available
for you as customer.
operationId: -checks-command-categories-
x-api-path-slug: checkscommandcategories-get
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/command-v2/categories ':
' get ':
summary: Checks Command Categories
description: Gets a list of all command check (version 2) categories that are
available for you as customer.
operationId: -checks-command-v2-categories-
x-api-path-slug: checkscommandv2categories-get
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/command/locations ':
' get ':
summary: Checks Command Locations
description: Gets a list of all locations that are available for Command checks.
operationId: -checks-command-locations-
x-api-path-slug: checkscommandlocations-get
responses:
200:
description: OK
tags:
- Checks
- Command
/checks/command-v2/locations:
' get ':
summary: Checks Command Locations
description: Gets a list of all locations that are available for Command checks
(version 2).
operationId: -checks-command-v2-locationsprotocolprotocol-
x-api-path-slug: checkscommandv2locations-get
responses:
200:
description: OK
tags:
- Checks
- Command
'/checks/{checkId}/job ':
' get ':
summary: Get Checks Job
description: DEPRECATED. Gets the current job status for a check.
operationId: -checks-checkid-job-
x-api-path-slug: checkscheckidjob-get
responses:
200:
description: OK
tags:
- Checks
- Jobs
' post ':
summary: Get Checks Job
description: Executes a check.
operationId: -checks-checkid-job-
x-api-path-slug: checkscheckidjob-post
responses:
200:
description: OK
tags:
- Checks
- Jobs
'/checks/ping ':
' post ':
summary: Checks Ping
description: Creates a new Ping check.
operationId: -checks-ping-
x-api-path-slug: checksping-post
responses:
200:
description: OK
tags:
- Checks
- Pings
'/checks/ping/{checkId} ':
' put ':
summary: Checks Ping
description: Updates a Ping check.
operationId: -checks-ping-checkid-
x-api-path-slug: checkspingcheckid-put
responses:
200:
description: OK
tags:
- Checks
- Pings
'/checks/ping/locations ':
' get ':
summary: Checks Ping Locations
description: Gets a list of all locations that are available for Ping checks.
operationId: -checks-ping-locations-
x-api-path-slug: checkspinglocations-get
responses:
200:
description: OK
tags:
- Checks
- Pings
'/checks/port ':
' post ':
summary: Checks Port
description: Creates a new Port check.
operationId: -checks-port-
x-api-path-slug: checksport-post
responses:
200:
description: OK
tags:
- Checks
- Ports
'/checks/port/{checkId} ':
' put ':
summary: Checks Port
description: Updates a Port check.
operationId: -checks-port-checkid-
x-api-path-slug: checksportcheckid-put
responses:
200:
description: OK
tags:
- Checks
- Ports
'/checks/port/locations ':
' get ':
summary: Checks Port Locations
description: Gets a list of all locations that are available for Port checks.
operationId: -checks-port-locations-
x-api-path-slug: checksportlocations-get
responses:
200:
description: OK
tags:
- Checks
- Ports
'/checks/proxysniffer ':
' post ':
summary: Checks Proxy Sniffer
description: Creates a new ProxySniffer check.
operationId: -checks-proxysniffer-
x-api-path-slug: checksproxysniffer-post
responses:
200:
description: OK
tags:
- Checks
- Proxy
'/checks/proxysniffer/{checkId} ':
' put ':
summary: Checks Proxy Sniffer
description: Updates a proxy sniffer check.
operationId: -checks-proxysniffer-checkid-
x-api-path-slug: checksproxysniffercheckid-put
responses:
200:
description: OK
tags:
- Checks
- Proxy
'/checks/proxysniffer/locations ':
' get ':
summary: Checks Proxy Sniffer Locations
description: Gets a list of all locations that are available for ProxySniffer
checks.
operationId: -checks-proxysniffer-locations-
x-api-path-slug: checksproxysnifferlocations-get
responses:
200:
description: OK
tags:
- Checks
- Proxy
'/checks/proxysniffer/{checkId}/results/{resultId}/urldata?format={format} ':
' get ':
summary: Checks Proxysniffer Results
description: Gets a file that contains ProxySniffer check result data.
operationId: -checks-proxysniffer-checkid-results-resultid-urldataformatformat-
x-api-path-slug: checksproxysniffercheckidresultsresultidurldataformatformat-get
responses:
200:
description: OK
tags:
- Checks
- Proxy
'/checks/proxysniffer/{checkId}/results/urldata ':
' post ':
summary: Checks Proxy Sniffer Results URLdata
description: Gets ProxySniffer check results in json format by result ids.
operationId: -checks-proxysniffer-checkid-results-urldata-
x-api-path-slug: checksproxysniffercheckidresultsurldata-post
responses:
200:
description: OK
tags:
- Checks
- Proxy
'/checks/proxysniffer/{checkId}/results/{resultId}/errorlog ':
' get ':
summary: Checks Proxy Sniffer Results Error Log
description: Gets an error log of the given ProxySniffer check result.
operationId: -checks-proxysniffer-checkid-results-resultid-errorlog-
x-api-path-slug: checksproxysniffercheckidresultsresultiderrorlog-get
responses:
200:
description: OK
tags:
- Checks
- Proxy
'/checks/url ':
' post ':
summary: Checks URL
description: Creates a new URL check (legacy version 1).
operationId: -checks-url-
x-api-path-slug: checksurl-post
responses:
200:
description: OK
tags:
- Checks
- URL
'/checks/url-v2 ':
' post ':
summary: Checks URL
description: Creates a new URL check (version 2).
operationId: -checks-url-v2-
x-api-path-slug: checksurlv2-post
responses:
200:
description: OK
tags:
- Checks
- URL
'/checks/url/{checkId} ':
' put ':
summary: Checks URL
description: Updates a URL check (legacy version 1).
operationId: -checks-url-checkid-
x-api-path-slug: checksurlcheckid-put
responses:
200:
description: OK
tags:
- Checks
- URL
'/checks/url-v2/{checkId} ':
' put ':
summary: Checks URL
description: Updates a URL check (version 2).
operationId: -checks-url-v2-checkid-
x-api-path-slug: checksurlv2checkid-put
responses:
200:
description: OK
tags:
- Checks
- URL
'/checks/url/locations ':
' get ':
summary: Checks URL Locations
description: Gets a list of all locations that are available for URL (legacy
version 1) checks.
operationId: -checks-url-locations-
x-api-path-slug: checksurllocations-get
responses:
200:
description: OK
tags:
- Checks
- URL
'/checks/url-v2/locations ':
' get ':
summary: Checks URL Locations
description: Gets a list of all locations that are available for URL (version
2) checks.
operationId: -checks-url-v2-locations-
x-api-path-slug: checksurlv2locations-get
responses:
200:
description: OK
tags:
- Checks
- URL
'/customers/{customerId} ':
' get ':
summary: Customers
description: Returns subcustomer by subcustomer's ID.
operationId: -customers-customerid-
x-api-path-slug: customerscustomerid-get
responses:
200:
description: OK
tags:
- Customers
'/customers ':
' post ':
summary: Customers
description: Creates customer.
operationId: -customers-
x-api-path-slug: customers-post
responses:
200:
description: OK
tags:
- Customers
'/customers/{customerId}/subscription ':
' put ':
summary: Customers Subscription
description: Updates customer's subscription.
operationId: -customers-customerid-subscription-
x-api-path-slug: customerscustomeridsubscription-put
responses:
200:
description: OK
tags:
- Customers
'/groups ':
' get ':
summary: Groups
description: Gets a hierarchy of all monitor groups that are visible to you
as a user or a customer depending on the request context.
operationId: -groups-
x-api-path-slug: groups-get
responses:
200:
description: OK
tags:
- Groups
' post ':
summary: Groups
description: Creates a new monitor group.
operationId: -groups-
x-api-path-slug: groups-post
responses:
200:
description: OK
tags:
- Groups
'/groups/{groupId} ':
' put ':
summary: Groups
description: Updates a monitor group.
operationId: -groups-groupid-
x-api-path-slug: groupsgroupid-put
responses:
200:
description: OK
tags:
- Groups
' delete ':
summary: Groups
description: Deletes a monitor group by Id.
operationId: -groups-groupid-
x-api-path-slug: groupsgroupid-delete
responses:
200:
description: OK
tags:
- Groups
'/groups/{groupId}/checks ':
' get ':
summary: Group Checks
description: Gets a list of checks assigned to the monitor group.
operationId: -groups-groupid-checks-
x-api-path-slug: groupsgroupidchecks-get
responses:
200:
description: OK
tags:
- Groups
' post ':
summary: Group Checks
description: Assigns checks to the monitor group.
operationId: -groups-groupid-checks-
x-api-path-slug: groupsgroupidchecks-post
responses:
200:
description: OK
tags:
- Groups
' delete ':
summary: Groups Checks
description: Unassigns checks from the monitor group.
operationId: -groups-groupid-checks-
x-api-path-slug: groupsgroupidchecks-delete
responses:
200:
description: OK
tags:
- Groups
'/groups/{groupId}/users ':
' get ':
summary: Groups Users
description: Gets a list of users assigned to the monitor group.
operationId: -groups-groupid-users-
x-api-path-slug: groupsgroupidusers-get
responses:
200:
description: OK
tags:
- Groups
' post ':
summary: Groups Users
description: Assigns users to the monitor group.
operationId: -groups-groupid-users-
x-api-path-slug: groupsgroupidusers-post
responses:
200:
description: OK
tags:
- Groups
' delete ':
summary: Groups Users
description: ""
operationId: -groups-groupid-users-
x-api-path-slug: groupsgroupidusers-delete
responses:
200:
description: OK
tags:
- Groups
/buckets/{bucketKey}/messages:
delete:
summary: Delete Buckets Messages
description: Clear a bucket (remove all messages)..
operationId: deleteBucketsBucketkeyMessages
x-api-path-slug: bucketsbucketkeymessages-delete
parameters:
- in: path
name: bucketKey
description: Unique identifier for a bucket
responses:
200:
description: OK
tags:
- Buckets
- BucketKey
- Messages
get:
summary: Get Buckets Messages
description: Retrieve a list of messages in a bucket.
operationId: getBucketsBucketkeyMessages
x-api-path-slug: bucketsbucketkeymessages-get
parameters:
- in: query
name: before
description: Only return messages before the given Unix timestamp
- in: path
name: bucketKey
description: Unique identifier for a bucket
- in: query
name: count
description: Maxiumum number of messages to return
- in: query
name: since
description: Only return messages after the given Unix timestamp
responses:
200:
description: OK
tags:
- Buckets
- BucketKey
- Messages
post:
summary: Post Buckets Messages
description: Create a message.
operationId: postBucketsBucketkeyMessages
x-api-path-slug: bucketsbucketkeymessages-post
parameters:
- in: body
name: NewMessage
schema:
$ref: '#/definitions/holder'
responses:
200:
description: OK
tags:
- Buckets
- BucketKey
- Messages
/buckets/{bucketKey}/messages/{messageId}:
get:
summary: Get Buckets Messages Messageid
description: Retrieve the details for a single message..
operationId: getBucketsBucketkeyMessagesMessage
x-api-path-slug: bucketsbucketkeymessagesmessageid-get
parameters:
- in: path
name: bucketKey
description: Unique identifier for a bucket
- in: query
name: messageId
description: The unique identifier for this message
responses:
200:
description: OK
tags:
- Buckets
- BucketKey
- Messages
- MessageId
'/messages?active={active}&customerId={customerId} ':
' get ':
summary: Get Messages
description: Gets a list of UI messages. UI messages are used for user notifications
on announcements/information/warnings.
operationId: getMessagesActiveActive&customerCustomer
x-api-path-slug: messagesactiveactiveampcustomeridcustomerid-get
responses:
200:
description: OK
tags:
- Messages?active=active&customerId=customerId
'/messages ':
' post ':
summary: Post Messages
description: Creates an UI message.
operationId: postMessages
x-api-path-slug: messages-post
responses:
200:
description: OK
tags:
- Messages
'/messages/{id} ':
' get ':
summary: Get Messages
description: Gets an existing UI message by Id.
operationId: getMessages
x-api-path-slug: messagesid-get
responses:
200:
description: OK
tags:
- Messages
- Id
' put ':
summary: Put Messages
description: Updates an existing UI message.
operationId: putMessages
x-api-path-slug: messagesid-put
responses:
200:
description: OK
tags:
- Messages
- Id
' delete ':
summary: Delete Messages
description: Deletes an existing UI message.
operationId: deleteMessages
x-api-path-slug: messagesid-delete
responses:
200:
description: OK
tags:
- Messages
- Id
'/roles ':
' get ':
summary: Get Roles
description: Return user roles
operationId: getRoles
x-api-path-slug: roles-get
responses:
200:
description: OK
tags:
- Roles
'/scenarios/proxysniffer/dictionaries ':
' post ':
summary: Scenarios Proxy Sniffer Dictionaries
description: Adds Proxy Sniffer scenario custom dictionary.
operationId: postScenariosProxysnifferDictionaries
x-api-path-slug: scenariosproxysnifferdictionaries-post
responses:
200:
description: OK
tags:
- Scenarios
- Proxy
- Sniffer
- Dictionaries
'/scenarios/proxysniffer/dictionaries/{dictionary_key} ':
' get ':
summary: Scenarios Proxy Sniffer Dictionaries
description: Gets a Proxy Sniffer scenario custom dictionary by dictionary key.
Custom dictionary can contain any data used by Proxy Sniffer scripts which
needs to be stored separately from scripts.
operationId: getScenariosProxysnifferDictionariesDictionaryKey
x-api-path-slug: scenariosproxysnifferdictionariesdictionary-key-get
responses:
200:
description: OK
tags:
- Scenarios
- Proxy
- Sniffer
- Dictionaries
' put ':
summary: Scenarios Proxy Sniffer Dictionaries
description: Updates Proxy Sniffer scenario custom dictionary.
operationId: putScenariosProxysnifferDictionariesDictionaryKey
x-api-path-slug: scenariosproxysnifferdictionariesdictionary-key-put
responses:
200:
description: OK
tags:
- Scenarios
- Proxy
- Sniffer
- Dictionaries
basePath: /
x-streamrank:
polling_total_time_average: 0
polling_size_download_average: 0
streaming_total_time_average: 0
streaming_size_download_average: 0
change_yes: 0
change_no: 0
time_percentage: 0
size_percentage: 0
change_percentage: 0
last_run: ""
days_run: 0
minute_run: 0
---