Update Environment

put

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

Replaces the name and label of an environment belonging to the organization resolved from the access token.

Both fields are required and are a full replacement, not a patch: omitting one is a 400 rather than leaving it unchanged, so read GET /environments first if you only mean to change one of them.

metaRegion is not part of the request. An environment cannot be moved between regions once tenants have been assigned against its region, so it is fixed at creation. Tenant membership is not part of the request either — use PUT /environments/{environmentId}/tenants.

The response has no body.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

204

The environment was updated. 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

400Bad Request. A field failed validation (FIELD_VALIDATION, with field naming it), a path or query value could not be used (INVALID_PARAMETER), the request was rejected for another reason the caller can correct (BAD_REQUEST), or the body could not be parsed as JSON (MALFORMED_REQUEST_BODY).

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.

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.