GETPro+
/api/v1/models/{model_id}/nodes

List Nodes

Paginated list of node instances with filtering by type, folder, and full-text search. Returns a page of node summaries plus x-total-count header for pagination.

AuthentifizierungBearer mpt_... or OAuth JWT
Plan-AnforderungPro+

Parameter

NameTypPflichtfeldStandardBeschreibung
limitNumber50[List Nodes] Page size. Default: 50. Query parameter.
searchString[List Nodes] Full-text search across node labels and descriptions. Query parameter.
model_idString[List Nodes] UUID of the model. Path parameter.
localeString[List Nodes] Return labels and descriptions in this locale. Query parameter.
folder_idString[List Nodes] Restrict to nodes inside this folder (UUID). Query parameter.
orderStringasc[List Nodes] Sort direction: 'asc' or 'desc'. Query parameter.
node_typeString[List Nodes] Filter results to nodes of this type name. Query parameter.
offsetNumber0[List Nodes] Number of results to skip for pagination. Default: 0. Query parameter.
sortString[List Nodes] Field to sort by (e.g. 'label', 'updated_at'). Query parameter.

Beispielantwort

{"nodes": [{"id": "uuid", "label": "OAuth Integration", "node_type": "Feature", "properties": {"status": "planned"}}]} // x-total-count: 47