This article covers how to get started with the Site 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 sites, start with About Sites.
Protobuf and OpenAPI specifications for Kentik’s v6 APIs are available in our api-schema-public repository.
Site Usage
The topics below provide important background information for the use of these APIs.
Overview
The Site Configuration API provides programmatic access to configuration of Sites and Site Markets:
Site: A site is a specific user-defined physical location (e.g., a data center at a given address) or logical location at which there is hosting of your devices, services, providers, or partner networks. Information that can be associated with a site includes the classification of IP addresses and the site's logical network topology/architecture.
Site Market: Sites with any common characteristics of your choosing (e.g., all PoPs in a particular region) can be logically grouped into a site market.
Both REST endpoint and gRPC RPCs are provided.
Notes:
Once a site is created in Kentik, you can assign one or more devices to the site via the settings for those devices; to do so programmatically you'd use the v5 Device API (see Device Create).
Sites can also be managed using the legacy REST-only Site API, which provides access to a subset of site configuration attributes.
Site 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.
ListSiteMarkets
API: SiteService
REST Method | REST Endpoint | Description | ||
---|---|---|---|---|
GET | /site/v202211 | Returns list of configured site markets. | ||
|
CreateSiteMarket
API: SiteService
REST Method | REST Endpoint | Description | ||
---|---|---|---|---|
POST | /site/v202211 | Create configuration for a new site market. Returns the newly created configuration. | ||
|
GetSiteMarket
API: SiteService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
GET | /site/v202211 | Returns configuration of a site market specified by ID. | ||||||||||
|
DeleteSiteMarket
API: SiteService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
DELETE | /site/v202211 | Deletes configuration of a site market with specific ID. | ||||||||||
|
UpdateSiteMarket
API: SiteService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
PUT | /site/v202211 | Replaces configuration of a site market with attributes in the request. Returns the updated configuration. | ||||||||||
|
ListSites
API: SiteService
REST Method | REST Endpoint | Description | ||
---|---|---|---|---|
GET | /site/v202211 | Returns list of configured sites. | ||
|
CreateSite
API: SiteService
REST Method | REST Endpoint | Description | ||
---|---|---|---|---|
POST | /site/v202211 | Create configuration for a new site. Returns the newly created configuration. | ||
|
GetSite
API: SiteService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
GET | /site/v202211 | Returns configuration of a site specified by ID. | ||||||||||
|
DeleteSite
API: SiteService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
DELETE | /site/v202211 | Deletes configuration of a site with specific ID. | ||||||||||
|
UpdateSite
API: SiteService
REST Method | REST Endpoint | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
PUT | /site/v202211 | Replaces configuration of a site with attributes in the request. Returns the updated configuration. | ||||||||||
|
Site Schemas
This API uses the following schemas.
protobufAny
Schema: protobufAny | Type: object | ||||||
Properties:
|
rpcStatus
Schema: rpcStatus | Type: object | ||||||||
Properties:
|
CreateSiteMarketRequest
Schema: v202211CreateSiteMarketRequest | Type: object | ||||
Properties:
|
CreateSiteMarketResponse
Schema: v202211CreateSiteMarketResponse | Type: object | ||||
Properties:
|
CreateSiteRequest
Schema: v202211CreateSiteRequest | Type: object | ||||
Properties:
|
CreateSiteResponse
Schema: v202211CreateSiteResponse | Type: object | ||||
Properties:
|
DeleteSiteMarketResponse
Schema: v202211DeleteSiteMarketResponse | Type: object |
Properties: None. |
DeleteSiteResponse
Schema: v202211DeleteSiteResponse | Type: object |
Properties: None. |
GetSiteMarketResponse
Schema: v202211GetSiteMarketResponse | Type: object | ||||
Properties:
|
GetSiteResponse
Schema: v202211GetSiteResponse | Type: object | ||||
Properties:
|
Layer
Schema: v202211Layer | Type: object | ||||||
Properties:
|
LayerSet
Schema: v202211LayerSet | Type: object | ||||
Properties:
|
ListSiteMarketsResponse
Schema: v202211ListSiteMarketsResponse | Type: object | ||||||
Properties:
|
ListSitesResponse
Schema: v202211ListSitesResponse | Type: object | ||||||
Properties:
|
PostalAddress
Schema: v202211PostalAddress | Type: object | ||||||||||||
Properties (* = required)
|
Site
Schema: v202211Site | Type: object | ||||||||||||||||||||
Properties (* = required)
|
SiteIpAddressClassification
Schema: v202211SiteIpAddressClassification | Type: object | ||||||||
Properties:
|
SiteMarket
Schema: v202211SiteMarket | Type: object | ||||||||||||||
Properties (* = required)
|
SiteType
Schema: v202211SiteType | Type: string | ||||||||
Attributes:
|
UpdateSiteMarketRequest
Schema: v202211UpdateSiteMarketRequest | Type: object | ||||
Properties:
|
UpdateSiteMarketResponse
Schema: v202211UpdateSiteMarketResponse | Type: object | ||||
Properties:
|
UpdateSiteRequest
Schema: v202211UpdateSiteRequest | Type: object | ||||
Properties:
|
UpdateSiteResponse
Schema: v202211UpdateSiteResponse | Type: object | ||||
Properties:
|
© 2014-25 Kentik