List Clerk JWT templates

List JWT templates in a connected Clerk application.

← All Clerk endpoints · Capability overview

GET/v1/clerk/jwt-templates

https://api.vee3.io/v1/clerk/jwt-templates

5 tokens

List JWT templates in a connected Clerk application.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

clerk.list_jwt_templates

Parameters1 field

clerk_instance_idstringOptional

Clerk instance id (ins_...) from clerk.get_connected_accounts. Omit to use the default connected account.

Response13 fields

jwt_templatesarrayitems

11 fields

JWT templates in the connected Clerk application.

idstring

Clerk JWT template id (jtmp_...).

namestring

Unique template name used when minting tokens from this template.

claimsobject

2 fields

JWT claims template as a JSON object (may include Clerk shortcodes).

audstring

Audience claim when set in the template.

rolestring

Role claim when set in the template.

lifetimeinteger

Token lifetime in seconds (exp claim offset from issuance time).

allowed_clock_skewinteger

Allowed clock skew in seconds for the nbf claim.

created_atinteger

Unix timestamp in milliseconds when the template was created.

updated_atinteger

Unix timestamp in milliseconds when the template was last updated.

signing_algorithmstring

Custom signing algorithm when custom_signing_key is enabled.

custom_signing_keyboolean

Whether this template uses a custom signing key and algorithm.

total_countinteger

Total number of JWT templates.

HTTP errors: clerk_connection_required, clerk_connection_not_found, clerk_connection_invalid, validation_error, unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/clerk/jwt-templates"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {

}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200JWT templates from a connected Clerk application.

jwt_template_list.json

{
  "jwt_templates": [
    {
      "id": "jtmp_2abc123",
      "name": "supabase",
      "claims": {
        "aud": "authenticated",
        "role": "authenticated"
      },
      "lifetime": 3600,
      "allowed_clock_skew": 5,
      "created_at": 1710000000000,
      "updated_at": 1710000000000,
      "signing_algorithm": null,
      "custom_signing_key": false
    }
  ],
  "total_count": 1
}