---
title: "Update the list of permissions to an environment for team members of an app"
method: PATCH
path: "/apps/{appId}/environments/{environmentId}/permissions"
tags: ["permissions"]
---

# Update the list of permissions to an environment for team members of an app

`PATCH /apps/{appId}/environments/{environmentId}/permissions`

## Request

- Base URL: `https://cloud.home.mendix.com/api/v4`
- URL: `https://cloud.home.mendix.com/api/v4/apps/{appId}/environments/{environmentId}/permissions`
- Auth: API key in header `Authorization`

Updates the permissions of one or more application team members to the specified environment.

## Request body

- object
  - `permissions` PermissionPatch[]
    - `member` object
      - `userId` string: The ID of the user.
    - `canDeployApp` boolean
    - `canManageBackups` boolean
    - `canViewAlerts` boolean
    - `canAccessAPI` boolean
    - `canViewLogs` boolean
    - `canManagePrivileges` boolean

## Response `200`

OK

- object
  - `permissions` PermissionPatch[]
    - `member` object
      - `userId` string: The ID of the user.
    - `canDeployApp` boolean
    - `canManageBackups` boolean
    - `canViewAlerts` boolean
    - `canAccessAPI` boolean
    - `canViewLogs` boolean
    - `canManagePrivileges` boolean

## Other responses

- `400`: The request probably contains invalid data or there is data missing from the request. The error response gives additional feedback.
- `401`: There were no usable authentication credentials found. The error response gives additional feedback.
- `403`: Access is denied. The provided credentials are incorrect or the credentials do not have the required level of access. The error response gives additional feedback.
- `404`: The requested item could not be found. The error response gives additional feedback.
- `500`: Internal system error.

---

[API](https://skmtc.dev/mendix/apis/deploy-api.md) - [All operations](https://skmtc.dev/mendix/apis/deploy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/deploy-api/revisions/4e82641fb4c5?raw)