---
title: View and update a Telegraf Enterprise license
description: View the current Telegraf Enterprise license details, check entitlements and usage, replace an expiring license, or remove the license to revert to the free tier.
url: https://docs.influxdata.com/telegraf/controller/telegraf-enterprise/manage-license/
estimated_tokens: 1430
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/controller/telegraf-enterprise/manage-license/
date: '2026-06-24T05:47:49-07:00'
lastmod: '2026-06-24T05:47:49-07:00'
---
* Telegraf Enterprise
After a Telegraf Enterprise license is applied to Telegraf Controller, use
the user interface (UI) or API to inspect the license, monitor entitlements and
usage, replace the license at renewal, or remove the license to revert to the
free tier.
#### Telegraf Enterprise
Unlock higher configuration and agent limits, enhanced security features, and official support for Telegraf and Telegraf Controller.
[ Upgrade to Enterprise](/telegraf/enterprise/)
* [View the current license](#view-the-current-license)
* [View entitlements and usage](#view-entitlements-and-usage)
* [Replace a license](#replace-a-license)
* [Remove a license](#remove-a-license)
## View the current license
**In the UI**, navigate to **Settings \> Enterprise** to view:
* **License ID**: the unique identifier for your license. Include this
value when contacting InfluxData support.
* **Loaded**: the date and time the license was applied to this
Telegraf Controller instance.
* **Expires**: the contractual expiration date, with a status chip
indicating current state (valid, expiring, or expired).
* **Max configurations**: the configurations entitlement from the license.
* **Max reporting agents**: the reporting agents entitlement from the
license.
**From the API**, an Owner can call `GET /api/license` to retrieve the same
information for scripted checks:
```bash
curl -H "Authorization: Bearer YOUR_TC_API_TOKEN" \
https://telegraf_controller.example.com/api/license
```
Replace `YOUR_TC_API_TOKEN`with your Telegraf Controller API token.
Example response:
```json
{
"status": "valid",
"licenseId": "Xxxx0oXx-Xx0o-00Xx-oXxX-xX0oXx0oXx0o",
"issuedAt": "2024-01-15T10:00:00Z",
"expiresAt": "2026-12-31T00:00:00Z",
"maxConfigs": 100000,
"maxAgents": 18000,
"loadedAt": "2024-06-01T14:30:00Z"
}
```
If no license is applied, `GET /api/license` returns `404 Not Found`.
## View entitlements and usage
Any authenticated user can call `GET /api/license/entitlements` to see the
effective entitlements alongside current usage. This endpoint is the right
choice for monitoring dashboards and capacity-planning scripts because it
doesn’t require the Owner role and works on both licensed and unlicensed
instances.
```bash
curl -H "Authorization: Bearer YOUR_TC_API_TOKEN" \
https://telegraf_controller.example.com/api/license/entitlements
```
Replace `YOUR_TC_API_TOKEN`with your Telegraf Controller API token.
Example response on a licensed instance:
```json
{
"status": "valid",
"licenseId": "Xxxx0oXx-Xx0o-00Xx-oXxX-xX0oXx0oXx0o",
"expiresAt": "2026-12-31T00:00:00Z",
"enterpriseEnabled": true,
"entitlements": {
"maxConfigs": 100000,
"maxAgents": 18000
},
"usage": {
"configs": 47,
"agents": 183
}
}
```
Example response on an unlicensed instance:
```json
{
"status": "unlicensed",
"licenseId": null,
"expiresAt": null,
"enterpriseEnabled": false,
"entitlements": {
"maxConfigs": 20,
"maxAgents": 100
},
"usage": {
"configs": 8,
"agents": 12
}
}
```
## Replace a license
To apply a renewed or upgraded license, apply the new license through**Settings \> Enterprise** exactly the same way you[applied the first one](/telegraf/controller/telegraf-enterprise/apply-license/#apply-a-license-through-the-user-interface).
Telegraf Controller validates the new license and replaces the existing one
in place. The new entitlements take effect immediately with no restart.
#### Failed license updates never downgrade a valid license
If the new license fails validation, Telegraf Controller retains the
previously active license and returns an error describing the validation
failure. Your enterprise features and scale limits are unaffected. See[Troubleshoot licensing](/telegraf/controller/telegraf-enterprise/troubleshoot/) for
the error catalog.
## Remove a license
Removing a license reverts Telegraf Controller to the free tier. Only the**Owner** can remove a license.
1. Navigate to **Settings \> Enterprise**.
2. Click **Remove license**.
3. Confirm the action in the dialog.
The change takes effect immediately, with no restart required.
After removal:
* **Scale limits revert to the free tier**: 20 configurations and 100
reporting agents.
* **Enterprise features are disabled**: audit logging, LDAP authentication,
and OIDC authentication stop accepting new requests.
* **Existing resources above the free-tier limit are preserved** but cannot
grow. Create requests for configurations or agent registrations are
rejected with `402 Payment Required` until usage drops below the free-tier
limit.
* **Existing IdP-authenticated sessions remain valid** until they expire on
their own. New LDAP or OIDC logins are blocked. Local authentication becomes
the only authentication method for the UI. For users that only used IdP
authentication and do not have a configured password, an Owner or
Administrator must [initiate a password reset](/telegraf/controller/users/update/#reset-a-users-password)for that user.
To restore enterprise features and licensed entitlements, apply a license
again. See [Apply a license](/telegraf/controller/telegraf-enterprise/apply-license/).
#### Related
* [Apply a Telegraf Enterprise license](/telegraf/controller/telegraf-enterprise/apply-license/)
* [Telegraf Enterprise license enforcement](/telegraf/controller/telegraf-enterprise/license-enforcement/)