Delete Environment

delete

https://{region}.api.jamfcloud.com/organization/v1/environments/{environmentId}

Deletes an environment belonging to the organization resolved from the access token.

Only an empty environment can be deleted. Because tenants cannot be unassigned over this API, an environment that holds tenants stays in place and the request is rejected with 409; read GET /tenants and check environmentId to see what is in it. Environments Jamf manages on your behalf — those backing a Jamf-hosted domain — are never empty and cannot be deleted either.

The response has no body.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

204

The environment was deleted. The response has no body.

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

401Unauthorized. The access token is missing, invalid, or expired. The API Gateway rejects the request before it reaches the service.

404Not Found. No environment with this identifier exists for the organization resolved from the access token.

409Conflict. The environment still holds tenants, or it is one Jamf manages on your behalf, and only an empty environment can be deleted.

500Internal Server Error. The organization in the token could not be resolved, or an upstream dependency failed. The description is deliberately generic; quote traceId when reporting the failure.