Create JWT Template | API Reference | Descope Documentation

POST

/v1/mgmt/jwt/templates/create

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Create a new JWT template. Strict validation runs first — if it fails, the response carries a list of ValidationIssues with stable codes (RESERVED_CLAIM_KEY, NAME_MISSING, …) and the template is not saved. type must be "user" or "key". authSchema in {default,tenantOnly,none}. issuerType in {legacy,inbound,federated}. emptyClaimPolicy in {none,nil,delete}. The template field is the JSON object whose keys are claim names.

curl -X POST "https://api.descope.com/v1/mgmt/jwt/templates/create" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.descope.com/v1/mgmt/jwt/templates/create" \  -H "Content-Type: application/json" \  -d '{}'

ResponseOK

{
  "template": {
    "id": "string",
    "name": "string",
    "description": "string",
    "template": {},
    "source": "string",
    "tags": [
      "string"
    ],
    "authSchema": "string",
    "type": "string",
    "conformanceIssuer": true,
    "autoDCT": true,
    "enforceIssuer": true,
    "emptyClaimPolicy": "string",
    "overrideSubject": true,
    "issuerType": "string",
    "omitCustomClaimsFromDSR": true,
    "addJti": true,
    "excludePermissions": true
  }
}

{  "template": {    "id": "string",    "name": "string",    "description": "string",    "template": {},    "source": "string",    "tags": [      "string"    ],    "authSchema": "string",    "type": "string",    "conformanceIssuer": true,    "autoDCT": true,    "enforceIssuer": true,    "emptyClaimPolicy": "string",    "overrideSubject": true,    "issuerType": "string",    "omitCustomClaimsFromDSR": true,    "addJti": true,    "excludePermissions": true  }}

TypeScript

export interface Response {
template?: {
id?: string
name?: string
description?: string
template?: {

}
source?: string
tags?: string[]
authSchema?: string
type?: string
conformanceIssuer?: boolean
autoDCT?: boolean
enforceIssuer?: boolean
emptyClaimPolicy?: string
overrideSubject?: boolean
issuerType?: string
omitCustomClaimsFromDSR?: boolean
addJti?: boolean
excludePermissions?: boolean
}
}

export interface Response {template?: {id?: stringname?: stringdescription?: stringtemplate?: {}source?: stringtags?: string[]authSchema?: stringtype?: stringconformanceIssuer?: booleanautoDCT?: booleanenforceIssuer?: booleanemptyClaimPolicy?: stringoverrideSubject?: booleanissuerType?: stringomitCustomClaimsFromDSR?: booleanaddJti?: booleanexcludePermissions?: boolean}}

Was this helpful?

Authorization

Request Body