---
title: Auth token
description: Create and manage tokens used for authenticating and authorizing access to InfluxDB 3 Core resources.
url: https://docs.influxdata.com/influxdb3/core/api/auth-token/
estimated_tokens: 935
product: InfluxDB 3 Core
version: core
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/core/api/auth-token/
---

[Download InfluxDB 3 Core API Spec](/openapi/influxdb3-core-openapi.yml)

Create and manage tokens used for authenticating and authorizing access to InfluxDB 3 Core resources.

DELETE`/api/v3/configure/token`

### Delete token

Deletes a token.

#### Parameters

##### Query parameters

`token_name`requiredstring

The name of the token to delete.

Example request[Ask AI about this](#)

```sh
curl --request DELETE \
  "https://localhost:8181/api/v3/configure/token?token_name=TOKEN_NAME" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. The token has been deleted.

401Unauthorized access.

`data`object

`error`string

404Token not found.

POST`/api/v3/configure/token/admin`

### Create admin token

Creates an admin token.
An admin token is a special type of token that has full access to all resources in the system.

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/configure/token/admin" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

201Success. The admin token has been created.
The response body contains the token string and metadata.

`created_at`string \<date-time\>

`expiry`string \<date-time\>

`hash`string

`id`integer

`name`string

`token`string

Example request body

```json
{
  "created_at": "2025-04-18T14:02:45.331Z",
  "expiry": null,
  "hash": "00xx0Xx0xx00XX0x0",
  "id": 0,
  "name": "_admin",
  "token": "apiv3_00xx0Xx0xx00XX0x0"
}
```

401Unauthorized access.

`data`object

`error`string

POST`/api/v3/configure/token/admin/regenerate`

### Regenerate admin token

Regenerates an admin token and revokes the previous token with the same name.

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/configure/token/admin/regenerate" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

201Success. The admin token has been regenerated.

`created_at`string \<date-time\>

`expiry`string \<date-time\>

`hash`string

`id`integer

`name`string

`token`string

Example request body

```json
{
  "created_at": "2025-04-18T14:02:45.331Z",
  "expiry": null,
  "hash": "00xx0Xx0xx00XX0x0",
  "id": 0,
  "name": "_admin",
  "token": "apiv3_00xx0Xx0xx00XX0x0"
}
```

401Unauthorized access.

`data`object

`error`string

POST`/api/v3/configure/token/named_admin`

### Create named admin token

Creates a named admin token.
A named admin token is a special type of admin token with a custom name for identification and management.

#### Request bodyrequired

Content-Type:`application/json`

`expiry_secs`integer

Optional expiration time in seconds. If not provided, the token does not expire.

`token_name`requiredstring

The name for the admin token.

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/configure/token/named_admin" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "expiry_secs": 0,
  "token_name": "TOKEN_NAME"
}'
```

#### Responses

201Success. The named admin token has been created.
The response body contains the token string and metadata.

`created_at`string \<date-time\>

`expiry`string \<date-time\>

`hash`string

`id`integer

`name`string

`token`string

Example request body

```json
{
  "created_at": "2025-04-18T14:02:45.331Z",
  "expiry": null,
  "hash": "00xx0Xx0xx00XX0x0",
  "id": 0,
  "name": "_admin",
  "token": "apiv3_00xx0Xx0xx00XX0x0"
}
```

401Unauthorized access.

`data`object

`error`string

409A token with this name already exists.

#### Related

* [Manage tokens](/influxdb3/core/admin/tokens/)
* [InfluxDB 3 API client libraries](/influxdb3/core/reference/client-libraries/v3/)