Note: This version replaces v202102alpha1. If you are looking for the older version, please refer to the portal's API Tester.
This article covers how to get started with the MKP APIs.
Notes:
The API Tester in the v4 Portal enables you to securely call the methods of these APIs using your organization's Kentik data.
For information about MKP, start with My Kentik Portal.
Protobuf and OpenAPI specifications for Kentik’s v6 APIs are available in our api-schema-public repository.
MKP Usage
The topics below provide important background information for the use of these APIs.
Overview
My Kentik Portal API enables programmatic access to tenants and package templates.
Endpoint | Purpose |
---|---|
TenantService | CRUD operations for MKP tenants. |
PackageService | CRUD operations for MKP templates. |
Both REST endpoint and gRPC RPCs are provided.
Tenant Attributes and Settings
Attribute | Access | Purpose |
---|---|---|
id | RO | System-generated unique identifier of the tenant |
company_id | RO | System-generated unique identifier of the company |
name | RW | User specified name for the tenant |
description | RW | User specified description for the tenant |
type | RO | subtenant |
enabled | RW | User specified tenant active status |
cdate | RO | Creation timestamp |
edate | RO | Last-modification timestamp |
alerts | RO | Alert policy configurations |
assets | RW | dashboard, views, and templates associate with tenant |
asn | RW | ASN data source |
cidr | RW | CIDR data source |
custom_dimensions | RW | Custom dimension data source |
devices | RW | Devices data source |
filters | RW | Data source filters |
interface_name | RW | Interface source filters |
snmp_alias | RW | SNMP source filters |
packages | RO | Package templates use by the tenant |
users | RO | Users assign to the tenant |
template_id | WO | Update tenant's packages setting with package/template id |
Package Attributes and Settings
Attribute | Access | Purpose |
---|---|---|
id | RO | System-generated unique identifier of the package |
company_id | RO | System-generated unique identifier of the company |
name | RW | User specified name for the package template |
description | RW | User specified description for the package template |
icon | RO | User specified icon |
color | RW | User specified color of icon |
alerts | RO | Alert policy configurations |
assets | RW | dashboard, views, and templates associate with tenant |
is_default | RW | Default package template to include for new tenant |
tenants | RO | Tenants using this package template |
MKP RPCs
The tables below provide a quick reference to key information about each Remote Procedure Call in these APIs. Use the links in the tables to see schemas for the request and/or response body (if any).
Note: To test methods using your own Kentik data, use the portal's API Tester.
PackageList
API: PackageService
REST Method | REST Endpoint | Description | ||||
---|---|---|---|---|---|---|
GET | /mkp/v202407 | Returns a list of MKP packages. | ||||
|
PackageCreate
API: PackageService
REST Method | REST Endpoint | Description | ||||
---|---|---|---|---|---|---|
POST | /mkp/v202407 | Create package from request. returns created package. | ||||
|
PackageGet
API: PackageService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
GET | /mkp/v202407 | Returns information about package specified with ID. | ||||||||||
Parameters:
|
PackageDelete
API: PackageService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
DELETE | /mkp/v202407 | Deletes the package specified with id. | ||||||||||
|
PackageUpdate
API: PackageService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
PUT | /mkp/v202407 | Update package attributes specified with id. | ||||||||||
|
TenantList
API: TenantService
REST Method | REST Endpoint | Description | ||||
---|---|---|---|---|---|---|
GET | /mkp/v202407 | Returns a list of MKP tenants. | ||||
|
TenantCreate
API: TenantService
REST Method | REST Endpoint | Description | ||||
---|---|---|---|---|---|---|
POST | /mkp/v202407 | Create tenant from request. returns created tenant. | ||||
|
TenantGet
API: TenantService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
GET | /mkp/v202407 | Returns information about package specified with ID. | ||||||||||
|
TenantDelete
API: TenantService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
DELETE | /mkp/v202407 | Deletes the tenant specified with id. | ||||||||||
|
TenantUpdate
API: TenantService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
PUT | /mkp/v202407 | Update tenant attributes specified with id. | ||||||||||
|
MKP Schemas
This API uses the following schemas.
AssetReport
Schema: AssetReport | Type: object | ||||||
Properties:
|
protobufAny
Schema: protobufAny | Type: object | ||||||
Properties:
|
rpcStatus
Schema: rpcStatus | Type: object | ||||||||
Properties:
|
PermissionEntry
Schema: v202211PermissionEntry | Type: object | ||||||
Properties (* = required)
|
Role
Schema: v202211Role | Type: string | ||||||||
Attributes:
|
User
Schema: v202211User | Type: object | ||||||||||||||||||||
Properties (* = required)
|
Activate
Schema: v202407Activate | Type: object | ||||||||||
Properties:
|
Alert
Schema: v202407Alert | Type: object | ||||||||||||||||
Properties:
|
Asset
Schema: v202407Asset | Type: object | ||||||
Properties:
|
Condition
Schema: v202407Condition | Type: object | ||||||||||||||
Properties:
|
CreatePackageRequest
Schema: v202407CreatePackageRequest | Type: object | ||||
Properties:
|
CreatePackageResponse
Schema: v202407CreatePackageResponse | Type: object | ||||
Properties:
|
CreateTenantRequest
Schema: v202407CreateTenantRequest | Type: object | ||||
Properties:
|
CreateTenantResponse
Schema: v202407CreateTenantResponse | Type: object | ||||
Properties:
|
CustomDimension
Schema: v202407CustomDimension | Type: object | ||||||
Properties:
|
DeletePackageResponse
Schema: v202407DeletePackageResponse | Type: object |
Properties: None |
DeleteTenantResponse
Schema: v202407DeleteTenantResponse | Type: object |
Properties: None |
Devices
Schema: v202407Devices | Type: object | ||||||||||||
Properties:
|
Filter
Schema: v202407Filter | Type: object | ||||||||||||||||||||
Properties:
|
FilterField
Schema: v202407FilterField | Type: object | ||||||||
Properties:
|
GetPackageResponse
Schema: v202407GetPackageResponse | Type: object | ||||
Properties:
|
GetTenantResponse
Schema: v202407GetTenantResponse | Type: object | ||||
Properties:
|
ListPackageResponse
Schema: v202407ListPackageResponse | Type: object | ||||||
Properties:
|
ListTenantResponse
Schema: v202407ListTenantResponse | Type: object | ||||||
Properties:
|
Mitigation
Schema: v202407Mitigation | Type: object | ||||||||||||||||||||||||
Properties:
|
NotificationChannel
Schema: v202407NotificationChannel | Type: object | ||||
Properties:
|
Package
Schema: v202407Package | Type: object | ||||||||||||||||||||||
Properties:
|
Tenant
Schema: v202407Tenant | Type: object | ||||||||||||||||||||||||||||||||||||||
Properties:
|
TenantLink
Schema: v202407TenantLink | Type: object | ||||||||
Properties:
|
Threshold
Schema: v202407Threshold | Type: object | ||||||||||||||||||||
Properties:
|
UpdatePackageRequest
Schema: v202407UpdatePackageRequest | Type: object | ||||
Properties:
|
UpdatePackageResponse
Schema: v202407UpdatePackageResponse | Type: object | ||||
Properties:
|
UpdateTenantRequest
Schema: v202407UpdateTenantRequest | Type: object | ||||
Properties:
|
UpdateTenantResponse
Schema: v202407UpdateTenantResponse | Type: object | ||||
Properties:
|
© 2014-25 Kentik