Skip to content

Test token claim rule

POST
/api/admin/token-claim-rules/{id}/test
Code sample: Shell / cURL
curl --request POST \
--url https://auth.example.com/api/admin/token-claim-rules/example/test \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "context": { "subject_id": "user_123", "client_id": "client_123", "scope": "openid profile", "roles": [ "employee" ], "permissions": [ "profile:read" ], "org_id": "org_123", "user_type": "member", "idp_claims": { "department": "Engineering" } } }'

Tests one token claim rule against a supplied evaluation context without writing token state.

id
required
string

Evaluation context for a single token claim rule.

Media type application/json
object
context
required
object
subject_id
required
string
client_id
required
string
scope
string
roles
Array<string>
permissions
Array<string>
org_id
string
org_type
string
user_type
string
idp_claims
object
key
additional properties
key
additional properties
key
additional properties
Example
{
"context": {
"subject_id": "user_123",
"client_id": "client_123",
"scope": "openid profile",
"roles": [
"employee"
],
"permissions": [
"profile:read"
],
"org_id": "org_123",
"user_type": "member",
"idp_claims": {
"department": "Engineering"
}
}
}

Single token claim rule test result.

Media type application/json
object
matched
boolean
claims_to_add
object
key
additional properties
claim_overrides
object
key
additional properties
reason
string
key
additional properties
Example
{
"matched": true,
"claims_to_add": {
"department": "Engineering"
},
"reason": "condition matched"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}