--- title: "Admin APIs" slug: "admin-apis" description: "Manage your organization's Kentik settings programmatically with V5 Admin APIs, accessing user, device, site, and tag data efficiently." updated: 2025-08-15T19:06:00Z published: 2025-08-15T19:06:00Z canonical: "kb.kentik.com/admin-apis" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.kentik.com/llms.txt > Use this file to discover all available pages before exploring further. # Admin APIs The Kentik V5 Admin APIs enable programmatic management of your organization’s Kentik admin settings. > [!NOTE] > **Notes:** > > - Member-level users can only access the GET methods of Admin APIs. > - For an overview of all Kentik APIs, see [**Kentik APIs**](/v1/docs/apis-overview). > - For information on using the V5 Admin APIs with cURL, see [**API Access Via cURL**](/v1/docs/apis-overview#api-access-via-curl). > - For help using any API version, contact [**support@kentik.com**](mailto:support@kentik.com). ## About V5 Admin APIs The Kentik V5 Admin APIs allow you to manage your organization’s Kentik settings programmatically. They provide methods to read/write backend information related to users, devices, sites, and tags. Information is returned in a JSON structure with key/value pairs within an HTTP response body. For more details on the data accessible via each API for your organization, refer to the following articles: - **User API**: Data for each user registered on the Kentik system (see [**Users**](/v1/docs/users)). - **Device API**: Data for each device (e.g., router, host) registered on the Kentik system (see [**About Devices**](/v1/docs/network-devices#about-devices)). - **Device Label API**: Manage [**Labels**](/v1/docs/labels) for devices. - **Plan API**: Access data on “plans”, which are services provided to you by Kentik (see [**About Plans**](/v1/docs/licenses#about-plans)). - **Site API**: Access data on “sites”, which are groups of devices based on geographic location (see [**Site Field Definitions**](/v1/docs/sites#site-field-definitions)). - **Tag API**: Access data on tags (see [**Flow Tags**](/v1/docs/flow-tags)). - **Custom Dimension API**: Access data on up to 10 custom dimensions and their associated populators (see [**Dimensions and Populators**](/v1/docs/custom-dimensions#dimensions-and-populators)). - **Saved Filter API**: Access data on custom filters saved by your users, see ([**Company Saved Filters**](/v1/docs/saved-filters#company-saved-filters)). - **Alerting APIs**: Manage and use Kentik’s alert-related features ([**Manual Mitigation**](/v1/docs/manual-mitigation) only). - **My Kentik API**: Manage the [**My Kentik Portal**](/v1/docs/my-kentik-portal) programmatically. Kentik V5 Admin APIs can be accessed via: - **Command line**: Use [**cURL**](https://curl.haxx.se/) in environments like Terminal (see [**API Access Via cURL**](/v1/docs/apis-overview#api-access-via-curl)). - **Programmatically**: Send a request body to a V5 API endpoint using any application language that supports HTTP. > [!NOTE] > **Note:** The V5 API tester was discontinued in January 2025. ## V5 Admin Methods The following table lists available methods in the V5 Admin APIs. Click the topic link for more details on each method: | Method | Endpoint | Description | Topic | | --- | --- | --- | --- | | **User API** | | GET | /users | Get information about all users | [**User List**](/v1/docs/user-api#user-list) | | GET | /user/user_id | Get information about a user | [**User Info**](/v1/docs/user-api#user-info) | | POST | /user | Create a new user | [**User Create**](/v1/docs/user-api#user-create) | | PUT | /user/user_id | Update user info | [**User Update**](/v1/docs/user-api#user-update) | | DELETE | /user/user_id | Delete a user | [**User Delete**](/v1/docs/user-api#user-delete) | | **Device API** | | GET | /devices | Get information about all devices | [**Device List**](/v1/docs/network-assets-apis#device-list) | | GET | /device/device_id | Get information about a device | [**Device Info**](/v1/docs/network-assets-apis#device-info) | | POST | /device | Create a new device | [**Device Create**](/v1/docs/network-assets-apis#device-create) | | PUT | /device/device_id | Update device info | [**Device Update**](/v1/docs/network-assets-apis#device-update) | | DELETE | /device/device_id | Delete a device | [**Device Delete**](/v1/docs/network-assets-apis#device-delete) | | GET | device/device_id/interfaces | Get information about all interfaces on a device | [**Interface List**](/v1/docs/network-assets-apis#interface-list) | | GET | device/device_id/interface/interface_id | Get information about an individual interface on a device | [**Interface Info**](/v1/docs/network-assets-apis#interface-info) | | POST | device_id/interface | Create a new interface on a device | [**Interface Create**](/v1/docs/network-assets-apis#interface-create) | | PUT | device/device_id/interface/interface_id | Update interface info | [**Interface Update**](/v1/docs/network-assets-apis#interface-update) | | DELETE | device/device_id/interface/interface_id | Delete an interface | [**Interface Delete**](/v1/docs/network-assets-apis#interface-delete) | | **Device Label API** | | GET | /deviceLabels | Get information about all labels | [**Device Label List**](/v1/docs/network-assets-apis#device-label-list) | | GET | /deviceLabels/label_id | Get information about a label | [**Device Label Info**](/v1/docs/network-assets-apis#device-label-info) | | POST | /deviceLabels | Create a new label | [**Device Label Create**](/v1/docs/network-assets-apis#device-label-create) | | PUT | /deviceLabels/label_id | Update label info | [**Device Label Update**](/v1/docs/network-assets-apis#device-label-update) | | DELETE | /deviceLabels/label_id | Delete a label | [**Device Label Delete**](/v1/docs/network-assets-apis#device-label-delete) | | **Plan API** | | GET | /plans | Get information about plans | [**Plan List**](/v1/docs/site-and-plan-apis#plan-list) | | **Site API** | | GET | /sites | Get information about all devices | [**Site List**](/v1/docs/site-and-plan-apis#site-list) | | GET | /site/site_id | Get information about a device | [**Site Info**](/v1/docs/site-and-plan-apis#site-info) | | POST | /site | Create a new device | [**Site Create**](/v1/docs/site-and-plan-apis#site-create) | | PUT | /site/site_id | Update device info | [**Site Update**](/v1/docs/site-and-plan-apis#site-update) | | DELETE | /site/site_id | Delete a device | [**Site Delete**](/v1/docs/site-and-plan-apis#site-delete) | | **Tag API** | | GET | /tags | Get information about all tags | [**Tag List**](/v1/docs/customization-apis#tag-list) | | GET | /tag/tag_id | Get information about a tag | [**Tag Info**](/v1/docs/customization-apis#tag-info) | | POST | /tag | Create a new tag | [**Tag Create**](/v1/docs/customization-apis#tag-create) | | PUT | /tag/tag_id | Update tag info | [**Tag Update**](/v1/docs/customization-apis#tag-update) | | DELETE | /tag/tag_id | Delete a tag | [**Tag Delete**](/v1/docs/customization-apis#tag-delete) | | **Custom Dimension API** | | GET | /customdimensions | Get information about all custom dimensions | [**Custom Dimension List**](/v1/docs/customization-apis#custom-dimension-list) | | GET | /customdimension/dimension_id | Get information about a custom dimension | [**Custom Dimension Info**](/v1/docs/customization-apis#custom-dimension-info) | | POST | /customdimension | Create a new custom dimension | [**Custom Dimension Create**](/v1/docs/customization-apis#custom-dimension-create) | | PUT | /customdimension/dimension_id | Update custom dimension info | [**Custom Dimension Update**](/v1/docs/customization-apis#custom-dimension-update) | | DELETE | /customdimension/dimension_id | Delete a custom dimension | [**Custom Dimension Delete**](/v1/docs/customization-apis#custom-dimension-delete) | | POST | /customdimension/dimension_id/populator | Create a new populator for a dimension | [**Populator Create**](/v1/docs/customization-apis#populator-create) | | PUT | /customdimension/dimension_id/populator/populator_id | Update populator info | [**Populator Update**](/v1/docs/customization-apis#populator-update) | | DELETE | /customdimension/dimension_id/populator/populator_id | Delete a populator | [**Populator Delete**](/v1/docs/customization-apis#populator-delete) | | **Batch API** | | POST | /batch/tags /batch/customdimensions/dimension_name/populators | Create, update, or delete tags or populators by the batch. | [**Batch Request**](/v1/docs/customization-apis#batch-request) | | GET | /batch/batch_operation_guid/status | Get status information about a batch operation. | [**Batch Status Request**](/v1/docs/customization-apis#batch-status-request) | | **Saved Filter API** | | GET | /saved-filters/custom | Get information about all custom saved filters. | [**Saved Filter List**](/v1/docs/customization-apis#saved-filter-list) | | GET | /saved-filter/saved-filter/custom/savedfilter_id | Get information about a custom saved filter. | [**Saved Filter Info**](/v1/docs/customization-apis#saved-filter-info) | | POST | /saved-filter/custom | Create a new custom saved filter. | [**Saved Filter Create**](/v1/docs/customization-apis#saved-filter-create) | | PUT | /saved-filter/saved-filter/custom/savedfilter_id | Update custom saved filter info. | [**Saved Filter Update**](/v1/docs/customization-apis#saved-filter-update) | | DELETE | /saved-filter/saved-filter/custom/savedfilter_id | Delete a custom saved filter. | [**Saved Filter Delete**](/v1/docs/customization-apis#saved-filter-delete) | | **Custom Application API** | | GET | /customApplications | Get information about all custom applications. | [**Custom Application API**](/v1/docs/customization-apis#custom-application-api) | | POST | /customApplications | Create a new custom application. | [**Custom Application API**](/v1/docs/customization-apis#custom-application-api) | | PUT | /customApplications/application_id | Update custom application info. | [**Custom Application API**](/v1/docs/customization-apis#custom-application-api) | | DELETE | /customApplications/application_id | Delete a custom application. | [**Custom Application API**](/v1/docs/customization-apis#custom-application-api) | | **Manual Mitigation API** | | POST | alerts/manual-mitigate | Start a new manual mitigation | [**Manual Mitigation Create**](/v1/docs/alerting-apis#manual-mitigation-create) | | **My Kentik API** | | GET | /mykentik/tenants | Get information about all tenants. | [**Tenant List**](/v1/docs/my-kentik-api#tenant-list) | | GET | /mykentik/tenant/tenant_id | Get information about an individual tenant. | [**Tenant Info**](/v1/docs/my-kentik-api#tenant-info) | | POST | /mykentik/tenant/tenant_id/user | Create a new tenant user. | [**Tenant User Create**](/v1/docs/my-kentik-api#tenant-user-create) | | DELETE | /mykentik/tenant/tenant_id/user/user_id | Delete a tenant user. | [**Tenant User Delete**](/v1/docs/my-kentik-api#tenant-user-delete) | > [!NOTE] > **Note:** Endpoint URLs are region-specific: > > - US: `https://api.kentik.com/api/v5` > - EU: `https://api.kentik.eu/api/v5`