> ## 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.

# Alterar a função de um membro do workspace

> Altere a função de um membro do workspace com PATCH /v2/workspaces/members para view, manager, maintain ou admin. Vale na hora; só o dono pode fazer isso.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `workspaces:manage`.

Altera a função de um membro já existente no workspace, com efeito imediato sobre o acesso dele às aplicações compartilhadas do workspace. As quatro funções são `view`, `manager`, `maintain` e `admin`: a [tabela de funções](/pt-br/api-reference/endpoint/workspace/members/invite#funções) mostra o que cada uma permite e o nome dela no dashboard.

Somente o dono do workspace pode chamar este endpoint, e o dono não pode alterar a própria função, já que sempre tem acesso total. Para adicionar um novo membro em vez de alterar um existente, veja [Convidar membro](/pt-br/api-reference/endpoint/workspace/members/invite). Limitado a 3 edições a cada 15 segundos por usuário.

## Parâmetros

<ParamField body="workspaceId" type="string" placeholder="ID do Workspace" required>
  O ID do workspace.
</ParamField>

<ParamField body="memberId" type="string" placeholder="ID do Membro" required>
  O ID do membro.
</ParamField>

<ParamField body="group" type="string" placeholder="Nome da permissão" required>
  A nova função: `view`, `manager`, `maintain` ou `admin`. Veja [Funções](/pt-br/api-reference/endpoint/workspace/members/invite#funções).
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

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

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `INVALID_ID` | 400 | `workspaceId` está ausente. |
| `MEMBER_NOT_FOUND` | 400 | `memberId` está ausente ou não pertence ao workspace. |
| `MEMBER_NOT_FOUND` | 404 | O membro não está mais no workspace (já foi removido). |
| `CANNOT_EDIT_OWNER` | 400 | O solicitante tentou alterar a própria função. |
| `INVALID_GROUP` | 400 | `group` não é `view`, `manager`, `maintain` ou `admin`. |
| `WORKSPACE_NOT_FOUND` | 404 | O workspace não existe. |

## Relacionados

* CLI: [`squarecloud workspace member update`](/pt-br/cli-reference/workspace-members#squarecloud-workspace-member-update)
* SDKs: [`api.workspaces.members.update()`](/pt-br/sdks/js/workspaces) (JavaScript), [`client.workspaces.members.update()`](/pt-br/sdks/py/workspaces) (Python), [`c.Workspaces.Members.Update()`](/pt-br/sdks/go/workspaces) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.