---
slug: espaco-de-trabalho/organizacoes
title: Organizações
description: Convide pessoas e organize equipes.
sidebar:
  order: 1
---

**Na Siglata, cada pessoa da organização tem uma função, como `owner`, `admin` ou `member`, e o agente dela trabalha só dentro dessa função e dos arquivos e pastas a que ela tem acesso.** Proprietários e administradores convidam membros, mudam funções e organizam equipes pelo agente.

A organização tem quantos membros quiser. O agente convida, lista e remove membros e muda o papel de cada um com `invitation_create`, `invitation_cancel`, `members_list`, `member_update_role` e `member_remove`, e também renomeia a organização. Para sair da organização ou excluí-la, use a página Conta do Console.

## Equipes [#teams]

Proprietários e administradores agrupam membros em equipes e compartilham arquivos e pastas com a equipe inteira de uma vez.

- O agente cria, renomeia e exclui equipes e marca quem faz parte de cada uma com `teams_list`, `team_set` e `team_delete`.
- Uma organização começa sem equipes, e cada membro pode estar em várias.
- Conceda uma pasta ou um arquivo a uma equipe com `grant_set` e `granteeType: "team"`. O acesso segue os membros atuais da equipe: quem entra passa a abrir o que ela recebeu, e quem sai deixa de abrir na requisição seguinte. Se não for possível confirmar de quais equipes alguém faz parte, a requisição é recusada.

## Perguntas frequentes [#faq]

### O agente vê arquivos que eu não posso abrir?

Não. O agente usa a função e os acessos de quem aprovou a conexão. Um item `restricted` que você não pode ler também não aparece nas listagens do seu agente.

### Quem pode convidar, remover membros ou mudar funções?

Proprietários e administradores, com o escopo `members:write` aprovado na conexão. Um membro com a função `member` não faz essas operações, mesmo que a conexão peça o escopo.

### O que acontece quando alguém sai da organização?

Os arquivos ficam na organização, e as conexões dos agentes dessa pessoa param de funcionar na próxima requisição.

### Como dou acesso a uma pasta para uma equipe inteira?

Peça ao agente para conceder a pasta à equipe. Ele usa `grant_set` com `granteeType: "team"`, e quem entra na equipe depois passa a abrir a pasta. Veja [Pastas e controle de acesso](/docs/espaco-de-trabalho/arquivos#folders-access).