@itentialopensource/adapter-kentik_v5
Version:
This adapter integrates with system described as: kentikV5Api.
1,583 lines (1,582 loc) • 129 kB
YAML
openapi: 3.0.0
info:
title: Kentik V5 API (https://api.kentik.com/api/v5/)
contact: {}
version: '1.0'
servers:
- url: https://api.kentik.com/api/v5
variables: {}
paths:
/query/sql:
post:
tags:
- Query Methods
summary: runQuery
description: This method allows you to run a SQL command against all configured devices. <a href='https://kb.kentik.com/Ec04.htm#Ec04-Query_SQL_Method' target='_blank'>Documentation</a>.
operationId: runQuery
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/runQuery'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/query/url:
post:
tags:
- Query Methods
summary: queryUrl
description: Returns a URL to view a given query in Data Explorer. <a href='https://kb.kentik.com/Ec04.htm#Ec04-Query_URL_Method' target='_blank'>Documentation</a>.
operationId: queryUrl
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/queryUrl'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/query/topxdata:
post:
tags:
- Query Methods
summary: topxdata
description: Returns query results in JSON that can be parsed to generate a TopX table. <a href='https://kb.kentik.com/Ec04.htm#Ec04-Query_Data_Method' target='_blank'>Documentation</a>.
operationId: topxdata
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/topxdata'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/query/topxchart:
post:
tags:
- Query Methods
summary: topxchart
description: Returns an image of a graph similar to what is seen in the Kentik portal's Data Explorer. <a href='https://kb.kentik.com/Ec04.htm#Ec04-Query_Chart_Method' target='_blank'>Documentation</a>.
operationId: topxchart
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/topxchart'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/users:
get:
tags:
- user
summary: findUsers
description: Returns an array of user objects, each of which contains information about an individual user (see <a href='https://kb.kentik.com/Cb02.htm#Cb02-User_Field_Definitions' target='_blank'>User Field Definitions</a>).<br/>* Required fields.
operationId: findUsers
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/user/{user_id}:
get:
tags:
- user
summary: findUser
description: Returns a user object containing information about an individual user (see <a href='https://kb.kentik.com/Cb02.htm#Cb02-User_Field_Definitions' target='_blank'>User Field Definitions</a>).<br/>* Required fields.
operationId: findUser
parameters:
- name: user_id
in: path
description: The ID of the user whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- user
summary: updateUser
description: Updates and returns a user object containing information about an individual user (see <a href='https://kb.kentik.com/Cb02.htm#Cb02-User_Field_Definitions' target='_blank'>User Field Definitions</a>).<br/>* Required fields.
operationId: updateUser
parameters:
- name: user_id
in: path
description: The ID of the user whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateUser'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- user
summary: deleteUser
description: Deletes a user from the system.<br/>* Required fields.
operationId: deleteUser
parameters:
- name: user_id
in: path
description: The id of the user to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/user:
post:
tags:
- user
summary: createUser
description: Creates and returns a user object containing information about an individual user (see <a href='https://kb.kentik.com/Cb02.htm#Cb02-User_Field_Definitions' target='_blank'>User Field Definitions</a>).<br/>* Required fields.
operationId: createUser
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createUser'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/devices:
get:
tags:
- device
summary: findDevices
description: Returns an array of device objects that each contain information about an individual device (see <a href='https://kb.kentik.com/Cb01.htm#Cb01-About_Devices' target='_blank'>About Devices</a>).<br/>* Required fields.
operationId: findDevices
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/device/{device_id}:
get:
tags:
- device
summary: findDevice
description: Returns a device object containing information about an individual device (see <a href='https://kb.kentik.com/Cb01.htm#Cb01-About_Devices' target='_blank'>About Devices</a>).<br/>* Required fields.
operationId: findDevice
parameters:
- name: device_id
in: path
description: The id of the device whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- device
summary: updateDevice
description: Updates and returns a device object containing information about an individual device (see <a href='https://kb.kentik.com/Cb01.htm#Cb01-About_Devices' target='_blank'>About Devices</a>).<br/>* Required fields.
operationId: updateDevice
parameters:
- name: device_id
in: path
description: The id of the device whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateDevice'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- device
summary: deleteDevice
description: Deletes a device.<br/>* Required fields.
operationId: deleteDevice
parameters:
- name: device_id
in: path
description: The id of the device to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/device:
post:
tags:
- device
summary: createDevice
description: Creates and returns a device object containing information about an individual device (see <a href='https://kb.kentik.com/Cb01.htm#Cb01-About_Devices' target='_blank'>About Devices</a>).<br/>* Required fields.<br/>** Conditionally required fields.
operationId: createDevice
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createDevice'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/devices/{device_id}/labels:
put:
tags:
- device
summary: deviceApplyLabels
description: Removes all existing labels from the device and applies the device labels (see <a href='https://kb.kentik.com/Cb16.htm#Cb16-About_Device_Labels' target='_blank'>About Device Labels</a>) specified by id. Returns a reduced version<br/>of device object containing an array of the applied labels.<br/>* Required fields.
operationId: deviceApplyLabels
parameters:
- name: device_id
in: path
description: The id of the device whose labels will be applied.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/deviceApplyLabels'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/device/{device_id}/interfaces:
get:
tags:
- device
summary: findInterfaces
description: Returns an array of interface objects that each contain information about an interface from a specified device.<br/>* Required fields.
operationId: findInterfaces
parameters:
- name: device_id
in: path
description: The id of the device whose interfaces will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/device/{device_id}/interface/{interface_id}:
get:
tags:
- device
summary: findInterface
description: Returns a interface object containing information about an individual interface from a given device.<br/>* Required fields.
operationId: findInterface
parameters:
- name: device_id
in: path
description: The id of the device whose interface information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
- name: interface_id
in: path
description: The id of the interface whose information will be returned. This is NOT the same as the interface's SNMP ID.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- device
summary: updateInterface
description: Updates and returns an interface object containing information about an individual interface from a specified device.<br/>* Required fields.<br/>*** Alternatively, instead of defining a vrf object, you can add the vrf_id.
operationId: updateInterface
parameters:
- name: device_id
in: path
description: The id of the device whose interface information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
- name: interface_id
in: path
description: The id of the interface whose information will be updated. This is NOT the same as the SNMP ID.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateInterface'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- device
summary: deleteInterface
description: Deletes an interface from a given device.<br/>* Required fields.
operationId: deleteInterface
parameters:
- name: device_id
in: path
description: The id of the device from which to delete the specified interface.
required: true
style: simple
schema:
type: integer
format: int32
- name: interface_id
in: path
description: The id of the interface to delete from the specified device.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/device/{device_id}/interface:
post:
tags:
- device
summary: createInterface
description: Creates and returns an interface object containing information about an individual interface for a given device.<br/>* Required fields.<br/>*** Alternatively, instead of defining a vrf object, you can add the vrf_id.
operationId: createInterface
parameters:
- name: device_id
in: path
description: The id of the device to which you want to add an interface.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createInterface'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/deviceLabels:
get:
tags:
- device label
summary: findDeviceLabels
description: Returns an array of device label objects that each contain information about an individual device label (see <a href='https://kb.kentik.com/Cb16.htm#Cb16-Device_Labels' target='_blank'>Device Labels</a>).<br/>* Required fields.
operationId: findDeviceLabels
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
post:
tags:
- device label
summary: createDeviceLabel
description: Creates and returns a device label object containing information about an individual device label (see <a href='https://kb.kentik.com/Cb16.htm#Cb16-Device_Labels' target='_blank'>Device Labels</a>).<br/>* Required fields.<br/>** Conditionally required fields.
operationId: createDeviceLabel
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createDeviceLabel'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/deviceLabels/{device_label_id}:
get:
tags:
- device label
summary: findDeviceLabel
description: Returns a device label object containing information about an individual device label (see <a href='https://kb.kentik.com/Cb16.htm#Cb16-Device_Labels' target='_blank'>Device Labels</a>).<br/>* Required fields.
operationId: findDeviceLabel
parameters:
- name: device_label_id
in: path
description: The id of the device label whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- device label
summary: updateDeviceLabel
description: Updates and returns a device label object containing information about an individual device label (see <a href='https://kb.kentik.com/Cb16.htm#Cb16-Device_Labels' target='_blank'>Device Labels</a>).<br/>* Required fields.
operationId: updateDeviceLabel
parameters:
- name: device_label_id
in: path
description: The id of the device label whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateDeviceLabel'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- device label
summary: deleteDeviceLabel
description: Deletes a device label.<br/>* Required fields.
operationId: deleteDeviceLabel
parameters:
- name: device_label_id
in: path
description: The id of the device label to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/plans:
get:
tags:
- plan
summary: findPlans
description: Returns an array of plan objects, each of which contains information about an individual plan.
operationId: findPlans
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/sites:
get:
tags:
- site
summary: findSites
description: Returns an array of site objects, each of which contains information about an individual site (see <a href='https://kb.kentik.com/Cb13.htm#Cb13-About_Sites' target='_blank'>About Sites</a>).<br/>* Required fields.
operationId: findSites
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/site/{site_id}:
get:
tags:
- site
summary: findSite
description: Returns a site object containing information about an individual site (see <a href='https://kb.kentik.com/Cb13.htm#Cb13-About_Sites' target='_blank'>About Sites</a>).<br/>* Required fields.
operationId: findSite
parameters:
- name: site_id
in: path
description: The ID of the site whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- site
summary: updateSite
description: Updates and returns a site object containing information about an individual site (see <a href='https://kb.kentik.com/Cb13.htm#Cb13-About_Sites' target='_blank'>About Sites</a>).<br/>* Required fields.
operationId: updateSite
parameters:
- name: site_id
in: path
description: The id of the site whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateSite'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- site
summary: deleteSite
description: Deletes a site.<br/>* Required fields.
operationId: deleteSite
parameters:
- name: site_id
in: path
description: The id of the site to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/site:
post:
tags:
- site
summary: createSite
description: Creates and returns a site object containing information about an individual site (see <a href='https://kb.kentik.com/Cb13.htm#Cb13-About_Sites' target='_blank'>About Sites</a>).<br/>* Required fields.
operationId: createSite
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createSite'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/tags:
get:
tags:
- tag
summary: findTags
description: Returns an array of tag objects that each contain information about an individual tag (see <a href='https://kb.kentik.com/Eb02.htm#Eb02-About_Tags' target='_blank'>About Tags</a>).
operationId: findTags
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/tag/{tag_id}:
get:
tags:
- tag
summary: findTag
description: Returns a tag object containing information about an individual tag (see <a href='https://kb.kentik.com/Eb02.htm#Eb02-About_Tags' target='_blank'>About Tags</a>).<br/>* Required fields.
operationId: findTag
parameters:
- name: tag_id
in: path
description: The id of the tag whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- tag
summary: updateTag
description: Updates and returns a tag object containing information about an individual tag (see <a href='https://kb.kentik.com/Eb02.htm#Eb02-About_Tags' target='_blank'>About Tags</a>).<br/>* Required fields.
operationId: updateTag
parameters:
- name: tag_id
in: path
description: The id of the tag whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateTag'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- tag
summary: deleteTag
description: Deletes a tag.<br/>* Required fields.
operationId: deleteTag
parameters:
- name: tag_id
in: path
description: The id of the tag to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/tag:
post:
tags:
- tag
summary: createTag
description: Creates and returns a tag object containing information about an individual tag (see <a href='https://kb.kentik.com/Eb02.htm#Eb02-About_Tags' target='_blank'>About Tags</a>).<br/>* Required fields.
operationId: createTag
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createTag'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customdimensions:
get:
tags:
- custom_dimension
summary: findCustomDimensions
description: Returns an array of custom dimension objects that each contain information about an individual custom dimension (see <a href='https://kb.kentik.com/proto/?Ec03.htm#Ec03-Custom_Dimension_API' target='_blank'>About Custom Dimensions</a>).
operationId: findCustomDimensions
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customdimension/{dimension_id}:
get:
tags:
- custom_dimension
summary: findCustomDimension
description: Returns a custom dimension object containing information about an individual custom dimension (see <a href='https://kb.kentik.com/proto/?Ec03.htm#Ec03-Custom_Dimension_API' target='_blank'>About Custom Dimensions</a>).<br/>* Required fields.
operationId: findCustomDimension
parameters:
- name: dimension_id
in: path
description: The id of the custom dimension whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- custom_dimension
summary: updateCustomDimension
description: Updates and returns a custom dimension object containing information about an individual custom dimension (see <a href='https://kb.kentik.com/proto/?Ec03.htm#Ec03-Custom_Dimension_API' target='_blank'>About Custom Dimensions</a>).<br/>* Required fields.<br/>Populators are not sent back in the response body. To get them use "Custom Dimension info" section instead.
operationId: updateCustomDimension
parameters:
- name: dimension_id
in: path
description: The id of the custom dimension whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateCustomDimension'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- custom_dimension
summary: deleteCustomDimension
description: Deletes a custom dimension.<br/>* Required fields.
operationId: deleteCustomDimension
parameters:
- name: dimension_id
in: path
description: The id of the custom dimension to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customdimension:
post:
tags:
- custom_dimension
summary: createCustomDimension
description: Creates and returns a custom dimension object containing information about an individual custom dimension (see <a href='https://kb.kentik.com/proto/?Ec03.htm#Ec03-Custom_Dimension_API' target='_blank'>About Custom Dimensions</a>).<br/>* Required fields.
operationId: createCustomDimension
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createCustomDimension'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customdimension/{dimension_id}/populator/:
post:
tags:
- custom_dimension
summary: createPopulator
description: Creates and returns a populator object containing information about an individual populator (see <a href='https://kb.kentik.com/proto/?Ec03.htm#Ec03-Custom_Dimension_API' target='_blank'>About Populators</a>).<br/>* Required fields.
operationId: createPopulator
parameters:
- name: dimension_id
in: path
description: The id of the custom dimension that contains the populator.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createPopulator'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customdimension/{dimension_id}/populator/{populator_id}:
put:
tags:
- custom_dimension
summary: updatePopulator
description: Updates and returns a populator object containing information about an individual populator (see <a href='https://kb.kentik.com/proto/?Ec03.htm#Ec03-Custom_Dimension_API' target='_blank'>About Populators</a>).<br/>* Required fields.
operationId: updatePopulator
parameters:
- name: populator_id
in: path
description: The id of the populator whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
- name: dimension_id
in: path
description: The id of the custom dimension that contains the populator.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updatePopulator'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- custom_dimension
summary: deletePopulator
description: Deletes a populator.<br/>* Required fields.
operationId: deletePopulator
parameters:
- name: populator_id
in: path
description: The id of the populator to delete.
required: true
style: simple
schema:
type: integer
format: int32
- name: dimension_id
in: path
description: The id of the custom dimension that contains the populator to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customApplications:
get:
tags:
- custom_application
summary: findCustomApplications
description: Returns an array of custom application object, each of which contains information about an individual custom application.<br/>* Required fields.
operationId: findCustomApplications
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
post:
tags:
- custom_application
summary: createCustomApplication
description: Creates and returns a custom application object containing information about an individual custom application.<br/>* Required fields.
operationId: createCustomApplication
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createCustomApplication'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/customApplications/{application_id}:
put:
tags:
- custom_application
summary: updateCustomApplication
description: Updates and returns a custom application object containing information about an individual custom application.<br/>* Required fields.
operationId: updateCustomApplication
parameters:
- name: application_id
in: path
description: The ID of the custom application whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateCustomApplication'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- custom_application
summary: deleteCustomApplication
description: Deletes a custom application from the system.<br/>* Required fields.
operationId: deleteCustomApplication
parameters:
- name: application_id
in: path
description: The id of the custom application to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/saved-filters/custom:
get:
tags:
- savedfilter
summary: findSavedFilters
description: Returns an array of saved filter objects, each of which contains information about an individual saved filter (see <a href='https://kb.kentik.com/Ec07.htm#Ec07-Saved_Filter_List' target='_blank'>Saved Filters</a>).<br/>* Required fields.
operationId: findSavedFilters
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/saved-filter/custom/{savedfilter_id}:
get:
tags:
- savedfilter
summary: findSavedFilter
description: Returns a saved filter object containing information about an individual saved filter (see <a href='https://kb.kentik.com/Ec07.htm#Ec07-Saved_Filter_Info' target='_blank'>Saved Filters</a>).<br/>* Required fields.
operationId: findSavedFilter
parameters:
- name: savedfilter_id
in: path
description: The ID of the saved filter whose information will be returned.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
put:
tags:
- savedfilter
summary: updateSavedFilter
description: Updates and returns a saved filter object containing information about an individual saved filter (see <a href='https://kb.kentik.com/Ec07.htm#Ec07-Saved_Filter_Update' target='_blank'>Saved Filters</a>).<br/>* Required fields.
operationId: updateSavedFilter
parameters:
- name: savedfilter_id
in: path
description: The ID of the saved filter whose information will be updated.
required: true
style: simple
schema:
type: integer
format: int32
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/updateSavedFilter'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
delete:
tags:
- savedfilter
summary: deleteSavedFilter
description: Deletes a saved filter from the system.<br/>* Required fields.
operationId: deleteSavedFilter
parameters:
- name: savedfilter_id
in: path
description: The id of the saved filter to delete.
required: true
style: simple
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/saved-filter/custom:
post:
tags:
- savedfilter
summary: createSavedFilter
description: Creates and returns a saved filter object containing information about an individual saved filter (see <a href='https://kb.kentik.com/Ec07.htm#Ec07-Saved_Filter_Create' target='_blank'>Saved Filters</a>).<br/>* Required fields.
operationId: createSavedFilter
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createSavedFilter'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/alerts/manual-mitigate:
post:
tags:
- alerts
summary: createManualMitigation
description: Creates a manual mitigation. A mitigation started manually will not clear on its own. It must be stopped manually from the active alerts page.
operationId: createManualMitigation
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/createManualMitigation'
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/alerts-active/alarms:
get:
tags:
- alerts_active
summary: alarms
description: Returns alarms.
operationId: alarms
parameters:
- name: startTime
in: query
description: startTime - The startTime of the alert. E.g. "2018-10-15T22:15:00".
required: true
style: form
explode: true
schema:
type: string
- name: endTime
in: query
description: endTime - The endTime of the alert. E.g. "2018-10-15T22:16:00".
required: true
style: form
explode: true
schema:
type: string
- name: filterBy
in: query
description: 'filterBy - The filter by field. (Acceptable values are: "", "old_state", "new_state", "any_state", "alert_key_partial", "dimension_key", "mitigation_id", "alert_id", "alert_key", "alarm_id")'
required: true
style: form
explode: true
schema:
type: string
- name: filterVal
in: query
description: filterVal - The filter by value.
required: true
style: form
explode: true
schema:
type: string
- name: showMitigations
in: query
description: showMitigations - 0 showMitigations off, 1 showMitigations on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
- name: showAlarms
in: query
description: showAlarms - 0 showAlarms off, 1 showAlarms on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
- name: showMatches
in: query
description: showMatches - 0 showMatches off, 1 showMatches on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
- name: learningMode
in: query
description: learningMode - 0 learning mode off, 1 learning mode on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/alerts-active/alerts-history:
get:
tags:
- alerts_active
summary: alertsHistory
description: Returns alerts history.
operationId: alertsHistory
parameters:
- name: startTime
in: query
description: startTime - The startTime of the alert. E.g. "2018-10-15T22:15:00".
required: true
style: form
explode: true
schema:
type: string
- name: endTime
in: query
description: endTime - The endTime of the alert. E.g. "2018-10-15T22:16:00".
required: true
style: form
explode: true
schema:
type: string
- name: filterBy
in: query
description: 'filterBy - The filter by field. (Acceptable values are: "", "old_state", "new_state", "any_state", "alert_key_partial", "dimension_key", "mitigation_id", "alert_id", "alert_key", "alarm_id")'
required: true
style: form
explode: true
schema:
type: string
- name: filterVal
in: query
description: filterVal - The filter by value.
required: true
style: form
explode: true
schema:
type: string
- name: sortOrder
in: query
description: 'sortOrder - The dimension to sort by. (Acceptable values are: "alert_key", "severity", "mitigation_id", "alarm_id", "alert_id", "alert_value", "alarm_state")'
required: true
style: form
explode: true
schema:
type: string
- name: showMitigations
in: query
description: showMitigations - 0 showMitigations off, 1 showMitigations on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
- name: showAlarms
in: query
description: showAlarms - 0 showAlarms off, 1 showAlarms on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
- name: showMatches
in: query
description: showMatches - 0 showMatches off, 1 showMatches on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
- name: learningMode
in: query
description: learningMode - 0 learning mode off, 1 learning mode on.
required: true
style: form
explode: true
schema:
type: integer
format: int32
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/mykentik/tenants:
get:
tags:
- My Kentik Portal
summary: findUserGroups
description: Returns an array of tenants, each of which contains information about an individual tenant (see <a href='https://kb.kentik.com/Cb15.htm#Cb15-Tenant_List' target='_blank'>Tenant List</a>).<br/>* Required fields.
operationId: findUserGroups
parameters: []
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
deprecated: false
/mykentik/tenant/{tenant_id}:
get: