---
title: "PUT Update folder"
method: PUT
path: "/api/folders/{identify}"
---

# PUT Update folder

`PUT /api/folders/{identify}`

Com este endpoint você pode atualizar informações das pastas, caso precise alterar o nome, visibilidade ou departamentos da mesma.

**Importante:** O único item que não pode ser alterado é o `Id`, que é o identificador único da pasta e deve ser utilizado ao enviar documentos para ela.

## Path parameters

- `identify` string, required

## Request body

- object
  - `name` string, required — Novo nome para a pasta.
  - `accessibility` 'Everyone' | 'Departments' | 'OnlyMe' — Visibilidade padrão da pasta.
  - `departments` integer[] — IDs dos departamentos.
  - `password` string — Define ou altera a senha do cofre. Deve conter no mínimo 4 caracteres. Ao informar este campo, a pasta é convertida automaticamente em um cofre protegido por senha.
  - `old_password` string, required — Senha atual da pasta. <br>• Se a pasta ainda não tiver senha, envie este campo vazio (""). <br>• Se já tiver uma senha, este campo deve conter a senha antiga. <br>• Se for remover a senha, envie vazio junto com password vazio.

## Response `200`

200

- object
  - `message` string — Mensagem de confirmação retornada pela API.
  - `data` object — Objeto principal contendo os dados da pasta atualizada.
    - `name` string — Nome atualizado da pasta.
    - `accessibility` 'Everyone' | 'Departments' | 'OnlyMe' — Visibilidade atualizada da pasta.
    - `departments` string — Lista de IDs dos departamentos com acesso à pasta.

## Other responses

- `404` — 404

---

[API](https://skmtc.net/plugsign/apis/endpoints-manuais.md) · [All operations](https://skmtc.net/plugsign/apis/endpoints-manuais/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plugsign/endpoints-manuais/versions/41e10c7c691b/schema)