Puppet HTTP API: Node

This version is out of date. For current versions, see Puppet packages and versions.


The node endpoint is used by the puppet agent to get basic information about a node. The returned information includes the node name and environment, and optionally any classes set by an External Node Classifier and a hash of parameters which may include the node’s facts. The returned node may have a different environment from the one given in the request if Puppet is configured with an ENC.


Retrieve data for a node

GET /:environment/node/:certname

Supported HTTP Methods


Supported Response Formats



> GET /production/node/mycertname HTTP/1.1
> Accept: pson, b64_zlib_yaml, yaml, raw

< HTTP/1.1 200 OK
< Content-Type: text/pson
< Content-Length: 4630



Returned node objects conform to the node schema.

See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.