Criando pastas

Como criar uma pasta normal ou compartilhada com a organização.

Criando uma pasta normal

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

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

Definindo os valores às variáveis:

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

E testando esta mutation no Altair:

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:

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:

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

E testando no Altair fica:

Você pode conferir o que é cada um desses parâmetros direto na documentação completa da API GraphQL, no menu Docs do Altair. Se você não sabe como fazer isso, confira o nosso tutorial:

Se você quer sair integrando e o Altair não está ajudando (você pode copiar a requisição como cURL no Altair), confira algumas SDKs/bibliotecas que podem ajudar: https://github.com/chentsulin/awesome-graphql