PagerDuty

this connector integrates pagerduty's rest api with swimlane turbine prerequisites the pagerduty asset requires an api key only account administrators have the ability to generate api tokens information on generating api tokens can be found here https //support pagerduty com/docs/using the api#section generating an api key capabilities the pagerduty connector has the following capabilities create an incident list teams list on calls list services list users list escalation policies api documentation link api documentation link https //developer pagerduty com/api reference/e65c5833eeb07 pager duty api configurations api key authentication authenticates using an api key configuration parameters parameter description type required url a url to the target host string required apikey api key in the authorization header of all requests that are sent to api gateway string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions create an incident create an incident synchronously without a corresponding event from a monitoring service endpoint url /incidents method post input argument name type required description incident object required unique identifier type string required type of the resource title string required parameter for create an incident service object required parameter for create an incident id string optional unique identifier type string optional type of the resource priority object optional parameter for create an incident id string optional unique identifier type string optional type of the resource urgency string optional parameter for create an incident body object optional request body data type string optional type of the resource details string optional parameter for create an incident incident key string optional unique identifier assignments array optional parameter for create an incident assignee object optional parameter for create an incident type string optional type of the resource escalation policy object optional parameter for create an incident id string optional unique identifier type string optional type of the resource conference bridge object optional unique identifier conference number string optional parameter for create an incident conference url string optional url endpoint for the request headers object required http headers for the request accept string required parameter for create an incident output parameter type description status code number http status code of the response reason string response reason phrase incident object unique identifier id string unique identifier type string type of the resource title string output field title summary string output field summary self string output field self html url string url endpoint for the request incident number number unique identifier created at string output field created at updated at string output field updated at status string status value incident key string unique identifier service object output field service id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request priority object output field priority id string unique identifier type string type of the resource summary string output field summary self string output field self example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "incident" {} } } ] list escalation policies list all of the existing escalation policies endpoint url /escalation policies method get input argument name type required description limit number optional parameter for list escalation policies offset number optional parameter for list escalation policies total boolean optional parameter for list escalation policies query string optional parameter for list escalation policies include\[] string optional parameter for list escalation policies sort by string optional parameter for list escalation policies team ids\[] array optional unique identifier user ids\[] array optional unique identifier headers object required http headers for the request accept string required parameter for list escalation policies content type string required type of the resource output parameter type description status code number http status code of the response reason string response reason phrase escalation policies array output field escalation policies id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request name string name of the resource escalation rules array output field escalation rules id string unique identifier escalation delay in minutes number output field escalation delay in minutes targets array output field targets id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request services array output field services id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request num loops number output field num loops example \[ { "status code" 200, "response headers" { "server" "nginx", "date" "fri, 10 nov 2023 07 39 08 gmt", "content type" "application/json", "transfer encoding" "chunked", "connection" "keep alive", "vary" "accept encoding, accept", "access control allow origin" " ", "x frame options" "sameorigin", "x xss protection" "1; mode=block, 1; mode=block", "x content type options" "nosniff, nosniff", "x download options" "noopen", "x permitted cross domain policies" "none", "referrer policy" "strict origin when cross origin, strict origin when cross origin", "access control allow methods" "get, post, put, delete, options", "access control max age" "1728000" }, "reason" "ok", "json body" { "escalation policies" \[], "limit" 25, "offset" 0, "more" false, "total" null } } ] list all of the on calls list the on call entries during a given time range endpoint url /oncalls method get input argument name type required description limit number optional parameter for list all of the on calls offset number optional parameter for list all of the on calls total boolean optional parameter for list all of the on calls earliest boolean optional parameter for list all of the on calls escalation policy ids\[] array optional unique identifier include\[] string optional parameter for list all of the on calls schedule ids\[] array optional unique identifier since string optional parameter for list all of the on calls time zone string optional parameter for list all of the on calls until string optional parameter for list all of the on calls user ids\[] array optional unique identifier headers object required http headers for the request accept string required parameter for list all of the on calls content type string required type of the resource output parameter type description status code number http status code of the response reason string response reason phrase oncalls array output field oncalls escalation policy object output field escalation policy id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request escalation level number output field escalation level schedule object output field schedule user object output field user id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request start object output field start end object output field end limit number output field limit offset number output field offset more boolean output field more total object output field total example \[ { "status code" 200, "response headers" { "server" "nginx", "date" "fri, 10 nov 2023 07 19 22 gmt", "content type" "application/json", "transfer encoding" "chunked", "connection" "keep alive", "vary" "accept encoding, accept", "access control allow origin" " ", "x frame options" "sameorigin", "x xss protection" "1; mode=block, 1; mode=block", "x content type options" "nosniff, nosniff", "x download options" "noopen", "x permitted cross domain policies" "none", "referrer policy" "strict origin when cross origin, strict origin when cross origin", "access control allow methods" "get, post, put, delete, options", "access control max age" "1728000" }, "reason" "ok", "json body" { "oncalls" \[], "limit" 25, "offset" 0, "more" true, "total" null } } ] list services list existing services endpoint url /services method get input argument name type required description limit number optional parameter for list services offset number optional parameter for list services total boolean optional parameter for list services query string optional parameter for list services include\[] string optional parameter for list services sort by string optional parameter for list services team ids\[] array optional unique identifier time zone string optional parameter for list services headers object required http headers for the request accept string required parameter for list services content type string required type of the resource output parameter type description status code number http status code of the response reason string response reason phrase services array output field services id string unique identifier name string name of the resource description string output field description created at string output field created at updated at string output field updated at status string status value teams array output field teams id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request alert creation string output field alert creation addons array output field addons file name string name of the resource file string output field file scheduled actions array output field scheduled actions file name string name of the resource file string output field file support hours object output field support hours last incident timestamp object unique identifier escalation policy object output field escalation policy example \[ { "status code" 200, "response headers" { "server" "nginx", "date" "fri, 10 nov 2023 07 28 11 gmt", "content type" "application/json", "transfer encoding" "chunked", "connection" "keep alive", "vary" "accept encoding, accept", "access control allow origin" " ", "x frame options" "sameorigin", "x xss protection" "1; mode=block, 1; mode=block", "x content type options" "nosniff, nosniff", "x download options" "noopen", "x permitted cross domain policies" "none", "referrer policy" "strict origin when cross origin, strict origin when cross origin", "access control allow methods" "get, post, put, delete, options", "access control max age" "1728000" }, "reason" "ok", "json body" { "services" \[], "limit" 25, "offset" 0, "total" null, "more" false } } ] list teams list teams of your pagerduty account, optionally filtered by a search query endpoint url /teams method get input argument name type required description limit number optional parameter for list teams offset number optional parameter for list teams query string optional parameter for list teams total boolean optional parameter for list teams headers object required http headers for the request accept string required parameter for list teams content type string required type of the resource output parameter type description status code number http status code of the response reason string response reason phrase teams array output field teams id string unique identifier name string name of the resource description object output field description type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request default role string output field default role parent object output field parent limit number output field limit offset number output field offset total object output field total more boolean output field more example \[ { "status code" 200, "response headers" { "server" "nginx", "date" "fri, 10 nov 2023 07 14 02 gmt", "content type" "application/json", "content length" "603", "connection" "keep alive", "access control allow origin" " ", "x frame options" "sameorigin", "x xss protection" "1; mode=block, 1; mode=block", "x content type options" "nosniff, nosniff", "x download options" "noopen", "x permitted cross domain policies" "none", "referrer policy" "strict origin when cross origin, strict origin when cross origin", "access control allow methods" "get, post, put, delete, options", "access control max age" "1728000", "access control allow headers" "authorization, content type, authorizationoauth, x early access, from" }, "reason" "ok", "json body" { "teams" \[], "limit" 25, "offset" 0, "total" null, "more" false } } ] list users list users of your pagerduty account, optionally filtered by a search query endpoint url /users method get input argument name type required description limit number optional parameter for list users offset number optional parameter for list users total boolean optional parameter for list users query string optional parameter for list users include\[] string optional parameter for list users team ids\[] array optional unique identifier headers object required http headers for the request accept string required parameter for list users content type string required type of the resource output parameter type description status code number http status code of the response reason string response reason phrase users array output field users name string name of the resource email string output field email time zone string output field time zone color string output field color avatar url string url endpoint for the request billed boolean output field billed role string output field role description object output field description invitation sent boolean output field invitation sent job title object output field job title teams array output field teams id string unique identifier type string type of the resource summary string output field summary self string output field self html url string url endpoint for the request contact methods array http method to use id string unique identifier type string type of the resource summary string output field summary self string output field self html url object url endpoint for the request example \[ { "status code" 200, "response headers" { "server" "nginx", "date" "fri, 10 nov 2023 07 30 38 gmt", "content type" "application/json", "transfer encoding" "chunked", "connection" "keep alive", "vary" "accept encoding, accept", "access control allow origin" " ", "x frame options" "sameorigin", "x xss protection" "1; mode=block, 1; mode=block", "x content type options" "nosniff, nosniff", "x download options" "noopen", "x permitted cross domain policies" "none", "referrer policy" "strict origin when cross origin, strict origin when cross origin", "access control allow methods" "get, post, put, delete, options", "access control max age" "1728000" }, "reason" "ok", "json body" { "users" \[], "limit" 25, "offset" 0, "total" null, "more" true } } ] response headers header description example access control allow headers http response header access control allow headers authorization, content type, authorizationoauth, x early access, from access control allow methods http response header access control allow methods get, post, put, delete, options access control allow origin http response header access control allow origin access control expose headers http response header access control expose headers access control max age http response header access control max age 1728000 cache control directives for caching mechanisms max age=0, private, must revalidate connection http response header connection keep alive content encoding http response header content encoding gzip content length the length of the response body in bytes 603 content type the media type of the resource application/json date the date and time at which the message was originated fri, 10 nov 2023 07 19 22 gmt etag an identifier for a specific version of a resource w/"42bc513c488f8a1265dde64c8abd264c" feature policy http response header feature policy accelerometer 'none'; camera 'none'; geolocation 'none'; gyroscope 'none'; magnetometer 'none'; microphone 'none'; payment 'none'; usb 'none' ratelimit limit http response header ratelimit limit 960 ratelimit remaining http response header ratelimit remaining 959 ratelimit reset http response header ratelimit reset 22 referrer policy http response header referrer policy strict origin when cross origin, strict origin when cross origin server information about the software used by the origin server nginx strict transport security http response header strict transport security max age=31536000; includesubdomains transfer encoding http response header transfer encoding chunked vary http response header vary accept x content type options http response header x content type options nosniff, nosniff x download options http response header x download options noopen x frame options http response header x frame options sameorigin x permitted cross domain policies http response header x permitted cross domain policies none notes for more information on pagerduty is found at pagerduty main site https //www pagerduty com/ for more information on pagerduty's developer site is found at pagerduty developer site https //developer pagerduty com/