---
title: Configuration
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[Token Validation](https://developers.cloudflare.com/api/go/resources/token_validation)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Configuration

##### [List token validation configurations](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/methods/list)

client.TokenValidation.Configuration.List(ctx, params) (\*V4PagePaginationArray\[[TokenConfig](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)>)], error)

GET/zones/{zone\_id}/token\_validation/config

##### [Get a token validation configuration](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/methods/get)

client.TokenValidation.Configuration.Get(ctx, configID, query) (\*[TokenConfig](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)>), error)

GET/zones/{zone\_id}/token\_validation/config/{config\_id}

##### [Create a token validation configuration](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/methods/create)

client.TokenValidation.Configuration.New(ctx, params) (\*[TokenConfig](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)>), error)

POST/zones/{zone\_id}/token\_validation/config

##### [Edit a token validation configuration](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/methods/edit)

client.TokenValidation.Configuration.Edit(ctx, configID, params) (\*[ConfigurationEditResponse](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration%20%3E%20(model)%20ConfigurationEditResponse%20%3E%20(schema)>), error)

PATCH/zones/{zone\_id}/token\_validation/config/{config\_id}

##### [Delete a token validation configuration](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/methods/delete)

client.TokenValidation.Configuration.Delete(ctx, configID, body) (\*[ConfigurationDeleteResponse](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration%20%3E%20(model)%20ConfigurationDeleteResponse%20%3E%20(schema)>), error)

DELETE/zones/{zone\_id}/token\_validation/config/{config\_id}

##### ModelsExpand Collapse

<details>

<summary>

type TokenConfig struct{…}

</summary>

ID string

UUID.

maxLength36

minLength36

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

CreatedAt Time

formatdate-time

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

<details>

<summary>

Credentials TokenConfigCredentials

</summary>

<details>

<summary>

Keys \[]TokenConfigCredentialsKey

</summary>

One of the following:

<details>

<summary>

type TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSA struct{…}

JSON representation of an RSA key.

</summary>

<details>

<summary>

Alg TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg

Algorithm

</summary>

One of the following:

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlgRs256 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg = "RS256"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg%20%3E%20(member)%200">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlgRs384 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg = "RS384"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg%20%3E%20(member)%201">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlgRs512 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg = "RS512"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg%20%3E%20(member)%202">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlgPs256 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg = "PS256"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg%20%3E%20(member)%203">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlgPs384 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg = "PS384"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg%20%3E%20(member)%204">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlgPs512 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAAlg = "PS512"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg%20%3E%20(member)%205">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20alg">Link to this property</a>

E string

RSA exponent

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20e">Link to this property</a>

Kid string

Key ID

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20kid">Link to this property</a>

Kty TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyRSAKty

Key Type

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20kty">Link to this property</a>

N string

RSA modulus

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200%20%3E%20(property)%20n">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%200">Link to this property</a>

<details>

<summary>

type TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs256 struct{…}

JSON representation of an ES256 key

</summary>

Alg TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs256Alg

Algorithm

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201%20%3E%20(property)%20alg">Link to this property</a>

Crv TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs256Crv

Curve

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201%20%3E%20(property)%20crv">Link to this property</a>

Kid string

Key ID

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201%20%3E%20(property)%20kid">Link to this property</a>

Kty TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs256Kty

Key Type

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201%20%3E%20(property)%20kty">Link to this property</a>

X string

X EC coordinate

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201%20%3E%20(property)%20x">Link to this property</a>

Y string

Y EC coordinate

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201%20%3E%20(property)%20y">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%201">Link to this property</a>

<details>

<summary>

type TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs384 struct{…}

JSON representation of an ES384 key

</summary>

Alg TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs384Alg

Algorithm

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202%20%3E%20(property)%20alg">Link to this property</a>

Crv TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs384Crv

Curve

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202%20%3E%20(property)%20crv">Link to this property</a>

Kid string

Key ID

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202%20%3E%20(property)%20kid">Link to this property</a>

Kty TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyEcEs384Kty

Key Type

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202%20%3E%20(property)%20kty">Link to this property</a>

X string

X EC coordinate

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202%20%3E%20(property)%20x">Link to this property</a>

Y string

Y EC coordinate

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202%20%3E%20(property)%20y">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%202">Link to this property</a>

<details>

<summary>

type TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponse struct{…}

JSON representation of a symmetric verification key in API responses (secret material is redacted).

</summary>

<details>

<summary>

Alg TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlg

Algorithm

</summary>

One of the following:

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlgHs256 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlg = "HS256"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203%20%3E%20(property)%20alg%20%3E%20(member)%200">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlgHs384 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlg = "HS384"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203%20%3E%20(property)%20alg%20%3E%20(member)%201">Link to this property</a>

const TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlgHs512 TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseAlg = "HS512"

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203%20%3E%20(property)%20alg%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203%20%3E%20(property)%20alg">Link to this property</a>

Kid string

Key ID

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203%20%3E%20(property)%20kid">Link to this property</a>

Kty TokenConfigCredentialsKeysAPIShieldCredentialsJWTKeyOctResponseKty

Key Type

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203%20%3E%20(property)%20kty">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys%20%3E%20(items)%20%3E%20(variant)%203">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials%20%3E%20(property)%20keys">Link to this property</a>

</details>

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20credentials">Link to this property</a>

Description string

maxLength500

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

LastUpdated Time

formatdate-time

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20last_updated">Link to this property</a>

Title string

maxLength50

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20title">Link to this property</a>

TokenSources \[]string

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20token_sources">Link to this property</a>

TokenType TokenConfigTokenType

<a href="#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)%20%3E%20(property)%20token_type">Link to this property</a>

</details>

[Link to this property](<#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)>)

#### ConfigurationCredentials

##### [Replace token validation credentials](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/subresources/credentials/methods/update)

client.TokenValidation.Configuration.Credentials.Update(ctx, configID, params) (\*[ConfigurationCredentialUpdateResponse](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration.credentials%20%3E%20(model)%20ConfigurationCredentialUpdateResponse%20%3E%20(schema)>), error)

PUT/zones/{zone\_id}/token\_validation/config/{config\_id}/credentials

##### [Edit token validation credentials](https://developers.cloudflare.com/api/go/resources/token_validation/subresources/configuration/subresources/credentials/methods/edit)

client.TokenValidation.Configuration.Credentials.Edit(ctx, configID, params) (\*[ConfigurationCredentialEditResponse](<https://developers.cloudflare.com/api/go/resources/token_validation#(resource)%20token_validation.configuration.credentials%20%3E%20(model)%20ConfigurationCredentialEditResponse%20%3E%20(schema)>), error)

PATCH/zones/{zone\_id}/token\_validation/config/{config\_id}/credentials