> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tylon.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurações

> Quem está no quadro e o que o papel de cada um permite, as regras que fazem a metade mecânica do trabalho, e as credenciais que deixam algo que não é um navegador entrar.

Quatro abas: **Geral**, **Pessoas**, **Regras** e **Erros**. As três abaixo são
as que mudam o que outras pessoas — e outras coisas — podem fazer aqui.

## Pessoas

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/tylon/tN7jKz4DGekqT4hM/images/pt-light/members.webp?fit=max&auto=format&n=tN7jKz4DGekqT4hM&q=85&s=5545323713261b49438edd014c1e2d0a" alt="Pessoas de um workspace do Tylon" width="2560" height="1640" data-path="images/pt-light/members.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/tylon/tN7jKz4DGekqT4hM/images/pt-dark/members.webp?fit=max&auto=format&n=tN7jKz4DGekqT4hM&q=85&s=3400278d2cc2bbcaf0f1fd197d467997" alt="Pessoas de um workspace do Tylon" width="2560" height="1640" data-path="images/pt-dark/members.webp" />
</Frame>

*O papel define o que cada pessoa pode fazer — e para quais status ela pode
mover um card.* Essa segunda metade é a que vale ler duas vezes: um papel aqui
não é uma etiqueta, é a resposta que o quadro dá quando alguém arrasta um card
para **In production**.

<ResponseField name="Dono">
  O workspace é dele, inclusive quem mais o tem.
</ResponseField>

<ResponseField name="Mantenedor">
  Promove. Os estágios que fazem merge em `main` nomeiam `Mantenedor` como
  papel mínimo [no quadro](/pt-br/screens/board).
</ResponseField>

<ResponseField name="Membro">
  Faz o trabalho: inicia cards, dá push em branches, abre pull requests.
</ResponseField>

<ResponseField name="Observador">
  Lê.
</ResponseField>

**Iris** e **Otto** estão nesta lista com papéis próprios. [Um
agente](/pt-br/screens/agents) é membro, então a mesma tabela responde "o que
este agente pode fazer" sem um segundo modelo de permissão para manter em dia
com o primeiro.

Convites são um link que você entrega — o Tylon monta e não envia o e-mail.

<Warning>
  O servidor é a autoridade. A interface esconde o que um papel não pode fazer,
  e esconder um botão é conveniência, nunca autorização — o mesmo movimento
  feito pela API ou pelo servidor MCP é recusado do mesmo jeito.
</Warning>

## Regras

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/tylon/tN7jKz4DGekqT4hM/images/pt-light/rules.webp?fit=max&auto=format&n=tN7jKz4DGekqT4hM&q=85&s=690eabe960af9939d609100bc6606821" alt="Regras de automação no Tylon" width="2560" height="1720" data-path="images/pt-light/rules.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/tylon/tN7jKz4DGekqT4hM/images/pt-dark/rules.webp?fit=max&auto=format&n=tN7jKz4DGekqT4hM&q=85&s=a9e72e18182025b8bccc5c65e4215e7f" alt="Regras de automação no Tylon" width="2560" height="1720" data-path="images/pt-dark/rules.webp" />
</Frame>

*A metade mecânica do trabalho: atribuir, etiquetar, priorizar, estacionar,
dizer algo.* Cada regra se lê como uma frase — **Quando** … **então** … — e a
linha abaixo dela diz se ela já rodou alguma vez.

```
Quando uma promoção é recusada          — então marcar como aguardando, adicionar uma etiqueta
Quando uma etiqueta é adicionada · security — então definir a prioridade
Quando um card fica parado por 3 dias · In review — então escrever no card
```

O terceiro gatilho é o que a maioria dos quadros não consegue expressar. *Ficar
parado* não é um evento: nada aconteceu, e nada acontecer por três dias é
exatamente a coisa que uma fila de revisão precisa que alguém note.

<Note>
  Tudo que exige julgamento é uma ação só — **acordar um agente** — porque
  regra que pensa é regra que ninguém consegue prever. Quando uma regra age,
  ela age como quem a escreveu, e a história do card nomeia a regra que agiu.
</Note>

## Credenciais da API

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/tylon/tN7jKz4DGekqT4hM/images/pt-light/api-credentials.webp?fit=max&auto=format&n=tN7jKz4DGekqT4hM&q=85&s=068bb6a7bfcef7d31fdb652c7073ef15" alt="Criando uma credencial da API do Tylon" width="768" height="1124" data-path="images/pt-light/api-credentials.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/tylon/tN7jKz4DGekqT4hM/images/pt-dark/api-credentials.webp?fit=max&auto=format&n=tN7jKz4DGekqT4hM&q=85&s=63249c0403a465f8b0f6a6f35a393783" alt="Criando uma credencial da API do Tylon" width="768" height="1124" data-path="images/pt-dark/api-credentials.webp" />
</Frame>

Como algo que não é um navegador lê e escreve aqui — um script de deploy, uma
página de status, uma planilha. Ele traz um client id e um segredo em vez de
uma pessoa passando por um login.

<ResponseField name="Boards que ela alcança">
  Um ou vários, cada um com o seu papel, do mesmo jeito que você conecta um
  editor. Em cada quadro ela pode fazer o que você marcou e nunca mais do que
  você tem lá — e ela mantém isso aconteça o que acontecer com você.
</ResponseField>

<ResponseField name="Escopos">
  `read` está sempre lá. `write` deixa abrir cards, movê-los, cortar branches e
  promover releases, cada escrita levando um `Idempotency-Key`.
</ResponseField>

O segredo é mostrado **uma vez**, quando é criado. Não há como mostrá-lo depois
sem guardá-lo legível, então tenha onde guardar antes de apertar o botão. Para
trocar, crie um segundo segredo, mova a integração para ele, e depois revogue o
antigo — os dois ficam vivos nesse meio-tempo, então nada fica fora do ar
durante a troca.

<Card title="A referência da API" icon="code" href="/pt-br/api-reference/authentication">
  O que enviar, em qual quadro uma requisição cai, e como as escritas
  continuam seguras de repetir.
</Card>
