# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autentique.com.br/api/2/mutations/criando-pastas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.