---
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
---

> ## 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`