• General information
  • Installation
  • Configuration
  • Usage/admin
  • Troubleshooting
  • PQL - Puppet Query Language
  • API
  • Query API version 4
  • Extensions API version 1 (PE-only)
  • Admin API version 1
  • Command API version 1
  • Status API version 1
  • Metadata API version 1
  • Metrics API version 1
  • Wire formats

Version endpoint

Sections

The /version endpoint can be used to retrieve version information from the PuppetDB server.

/pdb/meta/v1/version

This query endpoint will return version information about the running PuppetDB server.

This endpoint does not use any URL parameters or query strings.

/pdb/meta/v1/version/latest

This query will display a message describing the latest version of PuppetDB.

Response format

The response will be in application/json, and will return a JSON map with a single key: version, whose value is a string representation of the version of the running PuppetDB server.

{"version": "X.Y.Z"}

Examples

Using curl from localhost:

curl -X GET http://localhost:8080/pdb/meta/v1/version

{"version": "X.Y.Z"}

curl -X GET http://localhost:8080/pdb/meta/v1/version/latest

{
  "newer" : false,
  "product" : "puppetdb",
  "link" : "https://docs.puppetlabs.com/puppetdb/2.3/release_notes.html",
  "message" : "Version 2.3.4 is now available!",
  "version" : "2.3.4"
}
How helpful was this page?
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.