API index

APIs allow you to interact with Puppet and Puppet Enterprise (PE) applications from your own code or application integration hooks.

Puppet Enterprise APIs

For information on port requirements, see System configuration.


API	Useful for
Node inventory API v1	Making HTTP(S) requests to the Puppet inventory service API. Creating and deleting connection entries in the inventory service database. Listing the connections entries in the inventory database.
RBAC service API v1	Managing access to PE. Connecting to external directories. Generating authentication tokens. Managing users, user roles, user groups, and user permissions.
RBAC service API v2	Fetch users (with filters). Revoking authentication tokens. Managing LDAP.
Node classifier service API	Querying the groups that a node matches. Querying the classes, parameters, and variables that have been assigned to a node or group. Querying the environment that a node is in.
Orchestrator API	Gathering details about the orchestrator jobs you run. Inspecting applications and applications instances in your Puppet environments.
Code Manager API	Creating a webhook to trigger Code Manager. Queueing Puppet code deployments. Checking Code Manager and file sync status.
Status API	Checking the health status of PE services.
Activity service API	Querying PE service and user events logged by the activity service.
Value API	Generating reports about time and money freed by PE automation.

Open source Puppet Server, Puppet, PuppetDB, and Forge APIs


API	Useful for
Puppet Server administrative API endpoints `environment-cache` `jruby-pool`	Deleting environment caches created by a primary server. Deleting the Puppet Server pool of JRuby instances.
Server-specific Puppet API Environment classes Environment modules Static file content	Getting the classes and parameter information that is associated with an environment, with cache support. Getting information about what modules are installed in an environment. Getting the contents of a specific version of a file in a specific environment.
Puppet Server status API	Checking the state, memory usage, and uptime of the services running on Puppet Server.
Puppet Server metrics API	Querying Puppet Server performance and usage metrics. The `/metrics/v1/mbeans` endpoint is deprecated.
Puppet HTTP API	Retrieving a catalog for a node. Accessing environment information.
Certificate Authority (CA) API	Used internally by Puppet to manage agent certificates.
PuppetDB APIs	Querying the data that PuppetDB collects from Puppet. Importing and exporting PuppetDB archives. Changing the PuppetDB model of a population. Querying information about the PuppetDB server. Querying PuppetDB metrics.
Forge API	Finding information about modules and users on the Forge. Writing scripts and tools that interact with the Forge website.

Was this page helpful?

We’re sorry to hear that!
Please tell us why so we can help. Enter your feedback and email. This form is sent to the Puppet docs team. We ask for your email as we might contact you regarding your feedback. If you need help with the product itself, visit Puppet Support or ask in Puppet Community on Slack. Feedback:

Email Address:

To learn about how Puppet uses your personal information, visit our privacy policy.

If you leave us your email, we may contact you regarding your feedback. For more information on how Puppet uses your personal information, see our privacy policy.

See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project.