---
title: List latest node definitions
description: Use the listLatestNodeDefinitions action on the realm-config/authentication/authenticationtrees/nodes endpoint to get the most up-to-date definitions for all available nodes. This information is useful when creating or updating journeys because it provides the current node details.
component: pingoneaic
page_id: pingoneaic:am-authentication:list-latest-node-definitions
canonical_url: https://docs.pingidentity.com/pingoneaic/am-authentication/list-latest-node-definitions.html
keywords: ["Authentication", "Nodes & Trees", "Journeys", "REST API"]
---

# List latest node definitions

Use the `listLatestNodeDefinitions` action on the `realm-config/authentication/authenticationtrees/nodes` endpoint to get the most up-to-date definitions for all available nodes. This information is useful when creating or updating journeys because it provides the current node details.

This endpoint returns a list of node definitions for the *latest* version of each node, including the following information:

* Node version

* Node schema

* Configuration template

* Node outcomes

The following example shows a partial response for the `IdentityStoreDecisionNode`:

```bash
$ curl \
--request POST \
--header "Authorization: Bearer <access-token>" \
--header "Content-Type: application/json" \
--header "Accept-API-Version: protocol=2.1,resource=3.0" \
"https://<tenant-env-fqdn>/json/realms/root/realms/alpha/realm-config/authentication/authenticationtrees/nodes?_action=listLatestNodeDefinitions"
{
    "result": {
      ...
        "IdentityStoreDecisionNode": {
            "_id": "IdentityStoreDecisionNode",
            "name": "Identity Store Decision",
            "collection": true,
            "tags": [
                "basic authn",
                "basic authentication"
            ],
            "metadata": {
                "tags": [
                    "basic authn",
                    "basic authentication"
                ]
            },
            "help": "Verifies that the username and password values exist in the Identity Store configured in the realm.",
            "version": "1.0",
            "schema": {
                "type": "object",
                "properties": {
                    "minimumPasswordLength": {
                        "title": "Minimum Password Length",
                        "description": "When the password is changed the node will reject passwords which are shorter than this value. If this value is set to 0 the minimum password length is not checked by the node.",
                        "propertyOrder": 200,
                        "type": "integer",
                        "exampleValue": "",
                        "default": 8
                    },
                    "useUniversalIdForUsername": {
                        "title": "Username as Universal Identifier",
                        "description": "Set to true to allow the username to be represented by the user's universal identifier (uuid).  If set to false, the username representation will remain unchanged.",
                        "propertyOrder": 300,
                        "type": "boolean",
                        "exampleValue": "",
                        "default": false
                    },
                    "mixedCaseForPasswordChangeMessages": {
                        "title": "Use mixed case for password change messages",
                        "description": "Defines whether password change messages returned are in mixed (sentence) case or uppercase. Default: false",
                        "propertyOrder": 400,
                        "type": "boolean",
                        "exampleValue": "",
                        "default": false
                    }
                },
                "required": [
                    "minimumPasswordLength",
                    "useUniversalIdForUsername",
                    "mixedCaseForPasswordChangeMessages"
                ]
            },
            "template": {
                "useUniversalIdForUsername": false,
                "minimumPasswordLength": 8,
                "mixedCaseForPasswordChangeMessages": false
            },
            "outcomes": [
                {
                    "id": "TRUE",
                    "displayName": "True"
                },
                {
                    "id": "FALSE",
                    "displayName": "False"
                },
                {
                    "id": "LOCKED",
                    "displayName": "Locked"
                },
                {
                    "id": "CANCELLED",
                    "displayName": "Cancelled"
                },
                {
                    "id": "EXPIRED",
                    "displayName": "Expired"
                }
            ]
        },
      ...
}
```