> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Change Permissions

> Change workspace member permissions.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Changes the role of an existing workspace member, taking effect immediately on their access to the workspace's shared applications. The four roles are `view` (read-only), `manager` (app actions and deployment info), `maintain` (adds files, DNS, cache purge, and commits), and `admin` (adds envs, snapshots, custom domains, and the deploy webhook).

Only the workspace owner can call this endpoint, and the owner cannot change their own role since they always hold full access. To add a new member instead of changing an existing one, see [Invite Member](/en/api-reference/endpoint/workspace/members/invite). Rate limited to 3 edits per 15 seconds per user.

### Parameters

<ParamField body="workspaceId" type="string" placeholder="Workspace Id">
  The ID of the workspace.
</ParamField>

<ParamField body="memberId" type="string" placeholder="Member ID">
  The member ID.
</ParamField>

<ParamField body="group" type="string" placeholder="Permission name">
  The member permissions on the workspace applications.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful.. `success` if successful, `error` if not.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success"
  }
  ```
</ResponseExample>

### Common errors

| Code                  | HTTP | Meaning                                                       |
| --------------------- | ---- | ------------------------------------------------------------- |
| `INVALID_ID`          | 400  | `workspaceId` is missing.                                     |
| `MEMBER_NOT_FOUND`    | 400  | `memberId` is missing or does not belong to the workspace.    |
| `CANNOT_EDIT_OWNER`   | 400  | The caller tried to change their own role.                    |
| `INVALID_GROUP`       | 400  | `group` is not one of `view`, `manager`, `maintain`, `admin`. |
| `WORKSPACE_NOT_FOUND` | 404  | The workspace does not exist.                                 |