---
title: "POST Create folder"
method: POST
path: "/api/folders"
---

# POST Create folder

`POST /api/folders`

Com este endpoint você pode **criar pastas no sistema**, também é possível criar **subpastas** para melhor organização dos documentos.

Ao criar uma pasta você irá receber o **Id** da mesma, que é o identificador único dela no sistema, que pode ser utilizado para **recuperar documentos** e até mesmo **enviar documentos para pastas específicas**.

## Request body

- object
  - `folder` integer — ID da pasta onde a nova pasta será criada. Caso não seja informado, a pasta será criada diretamente na raiz.
  - `name` string, required — Nome da pasta visível dentro da plataforma
  - `accessibility` 'Everyone' | 'Departments' | 'OnlyMe' — Visibilidade padrão da pasta.
  - `departments` integer[] — Só é obrigatório se no campo de acesso passar departamentos, recebe uma lista dos departamentos da empresa que passam a ter acesso a pasta.
  - `password` string — Ao informar uma senha, a pasta passa a ser tratada como um cofre, exigindo autenticação de senha para acesso ao seu conteúdo.

## Response `200`

200

- object
  - `data` object — Objeto principal contendo os dados da pasta criada.
    - `id` integer — Identificador único da pasta.
    - `folder` string — Nome da pasta criada.
    - `accessibility` 'Everyone' | 'Departments' | 'OnlyMe' — Visibilidade da pasta.
    - `created_on` string — Data e hora de criação da pasta.

---

[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/revisions/41e10c7c691b/schema)