> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/mutations/criando-pastas.md).

# Criando Pastas

### Criando uma pasta normal

A *mutation* para criar uma pasta na conta do usuário autenticado (titular do token de API) é:

```graphql
mutation CreateFolderMutation($folder: FolderInput!) {
  createFolder(folder: $folder) {
    id
    name
    type
    created_at
  }
}
```

Definindo os valores às variáveis:

```javascript
{
  "folder": {
    "name": "Contratos assinados"
  }
}
```

E testando esta *mutation* no [Altair](https://altair.autentique.com.br):

![](/files/-LzJD6q7iONTI_tTWATM)

### Criando uma pasta compartilhada

Em comparação com a *mutation* de criar pastas, a única diferença é o parâmetro **type**. Portanto, usando quase a mesma *mutation* novamente, com o parâmetro:

```graphql
mutation SharedFolderMutation(
  $folder: FolderInput!,
  $type: FolderTypeEnum
) {
  createFolder(folder: $folder, type: $type) {
    id
    name
    type
    created_at
  }
}
```

E passando o valor do parâmetro **type** dessa vez, com o valor **ORGANIZATION**:

```javascript
{
  "folder": {
    "name": "Contratos compartilhados"
  },
  "type": "ORGANIZATION"
}
```

E testando no [Altair](https://altair.autentique.com.br) fica:

![](/files/-LzJDKOzS6K-7E7_KgGK)

### Criando uma Pasta/subpasta

Esta mutação permite a criação de uma nova pasta. Se um `parent_id` for fornecido, a pasta será criada como uma subpasta do diretório correspondente.

```graphql
mutation CreateSubfolder($parent_id: UUID, $folder: FolderInput!) {
  createFolder(parent_id: $parent_id, folder: $folder) {
    id
    name
    slug
    context
    path
    children_counter
    created_at
    updated_at
  }
}
```

{% hint style="warning" %}
Existe um limite máximo de 5 subpastas por pasta pai. Tentativas de criar mais subpastas retornarão um erro de validação.
{% endhint %}

{% hint style="info" %}
Se você quer ter criar um documento em uma pasta, use o atributo *folder\_id* na [Criação do documento](/api/2/mutations/criando-um-documento.md). Caso a intenção seja adicionar um documento existente em outra pasta já criada, veja como [mover documento para uma pasta](/api/2/mutations/movendo-documento-para-pasta.md).
{% endhint %}

{% hint style="info" %}
Você pode conferir o que é cada um desses parâmetros direto na documentação completa da API GraphQL, no menu Docs do [Altair](https://altair.autentique.com.br). Se você não sabe como fazer isso, confira o nosso tutorial em [Usando o Altair](/api/2/integracao/altair.md)
{% endhint %}

{% hint style="info" %}
Se o Altair não te ajuda para integrar com a API, confira alguns exemplos de como fazer essas requisições de outra forma: <https://graphql.org/graphql-js/graphql-clients/>
{% endhint %}

{% file src="/files/-M03o9cE5QB3vLoPUlzJ" %}
Para importar e usar no Postman
{% endfile %}