GuidesRecipesAPI ReferenceChangelog
Log In
Changelog
Added

11.31.0 Additions

What's new

GET /v2/environment-type — new

Returns the cloud services environment this Jamf Pro instance is configured to communicate with. Useful when a client needs to know whether it's pointed at a staging, production, or sandbox tenant without inferring it from the server URL. No privilege is required, so any authenticated client can read it.

Response: EnvironmentTypeenvironment is one of staging, production, or sandbox.

{
  "environment": "production"
}

GET /v2/smtp-server/allowed-auth-types — new

Returns the SMTP authentication types currently available on the instance. Availability is set at the instance level and is independent of the current SMTP settings, so check this before writing an authenticationType with PUT /v2/smtp-server — a type that isn't in this list will be rejected.

Requires Read SMTP Server.

Response: SmtpAuthenticationTypeListallowedAuthenticationTypes contains any of NONE, BASIC, GRAPH_API, and GOOGLE_MAIL.

{
  "allowedAuthenticationTypes": ["GRAPH_API", "GOOGLE_MAIL"]
}

GET /v1/pki/digicert/trust-lifecycle-manager/{id}/privilege-check — new

Checks whether the DigiCert account behind a Trust Lifecycle Manager configuration holds every permission needed to deploy certificates. Use it to catch a misconfigured DigiCert account before certificate deployment fails.

Requires Read DigiCert Settings.

StatusMeaning
204The account has all required permissions. No response body.
403The account is missing one or more permissions. ApiError lists the missing permission names.
404No Trust Lifecycle Manager configuration exists for the given id.