Validate JWT Template | API Reference

POST

/v1/mgmt/jwt/templates/validate

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

template?object

id?string

Dry-run validate a JWT template without saving. Pass either an inline template payload (to validate before create/update) or an existing id (to lint a saved template). Returns a list of ValidationIssues — empty list means valid.

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

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

ResponseOK

{
  "valid": true,
  "issues": [
    {
      "field": "string",
      "code": "string",
      "message": "string",
      "hint": "string"
    }
  ]
}

{  "valid": true,  "issues": [    {      "field": "string",      "code": "string",      "message": "string",      "hint": "string"    }  ]}

TypeScript

export interface Response {
valid?: boolean
issues?: JwtTemplateValidationIssue[]
}
/**
 * Single validation failure produced by ValidateJwtTemplate. `code` is a
 *  stable identifier callers (e.g. MCP agents) can pattern-match on.
 */
export interface JwtTemplateValidationIssue {
field?: string
code?: string
message?: string
hint?: string
}

export interface Response {valid?: booleanissues?: JwtTemplateValidationIssue[]}/** * Single validation failure produced by ValidateJwtTemplate. `code` is a *  stable identifier callers (e.g. MCP agents) can pattern-match on. */export interface JwtTemplateValidationIssue {field?: stringcode?: stringmessage?: stringhint?: string}

Was this helpful?