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

# Início rápido: Equipes

> Comece a usar a Devin API como usuário de equipe ou de organização padrão

Este guia explica como configurar o acesso à API para **equipes e organizações padrão** (não Enterprise). Você criará um usuário de serviço, obterá suas credenciais e fará sua primeira chamada à API em poucos minutos.

<Note>
  Se você fizer parte de uma conta Enterprise com múltiplas organizações, funções personalizadas ou SSO (Single Sign-On), consulte o [início rápido para Enterprise](/pt-BR/api-reference/getting-started/enterprise-quickstart).
</Note>

<h2 id="step-1-create-a-service-user">
  Etapa 1: Criar um usuário de serviço
</h2>

1. Acesse **Settings > Devin API** na sua organização e abra a aba **Usuários de serviço**
2. Clique em **Provision usuário de serviço**
3. Escolha um nome de exibição descritivo (por exemplo, "CI Pipeline", "Monitoring Bot")
4. Selecione uma função:
   * **Admin** — acesso total, incluindo configurações da organização e associação
   * **Member** — pode criar e gerenciar sessões do Devin e a maioria dos recursos da organização, mas não as configurações da organização nem a associação

<Tip>
  Use a função **Member** para a maior parte das automações. Use **Admin** somente se sua integração precisar gerenciar configurações da organização ou outros usuários.
</Tip>

<h2 id="step-2-copy-your-api-key">
  Etapa 2: Copie sua chave de API
</h2>

1. Após provisionar o usuário de serviço, a chave de API dele é exibida em uma caixa de diálogo
2. Copie a chave imediatamente — ela começa com `cog_` e não será exibida novamente
3. Armazene-a com segurança como uma variável de ambiente:

```bash theme={null}
export DEVIN_API_KEY="cog_your_key_here"
```

<h2 id="step-3-make-your-first-api-call">
  Etapa 3: Faça sua primeira chamada à API
</h2>

Crie uma sessão do Devin:

```bash theme={null}
export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
```

<Tip>
  Encontre o ID da sua organização no topo da página **Settings → Devin API**.
</Tip>

<Note>
  **Quer que as sessões sejam atribuídas ao seu usuário?** Por padrão, as sessões são atribuídas ao usuário de serviço. Para criar sessões em nome de um usuário específico (para que apareçam na lista de sessões desse usuário), adicione `"create_as_user_id": "user_abc123"` ao corpo da requisição. Isso requer a função **Admin** (que inclui a permissão `ImpersonateOrgSessions`). Consulte [Atribuição de sessões](/pt-BR/api-reference/overview#session-attribution) para mais detalhes.
</Note>

<h2 id="step-4-common-operations">
  Passo 4: Operações comuns
</h2>

<h3 id="list-your-sessions">
  Liste suas sessões
</h3>

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<h3 id="send-a-message-to-a-running-session">
  Enviar uma mensagem para uma sessão ativa
</h3>

```bash theme={null}
export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'
```

<h3 id="manage-knowledge">
  Gerenciar o Knowledge
</h3>

```bash theme={null}
# Listar entradas de Knowledge
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Criar uma entrada de Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger": "When writing code", "body": "Use TypeScript strict mode..."}'
```

<h2 id="permissions-for-teams-users">
  Permissões para usuários do Teams
</h2>

Organizações do Teams têm um modelo de permissões simples:

| Função | Pode criar sessões | Pode gerenciar recursos | Pode gerenciar configurações |
| - | - | - | - |
| **Member** | Sim | Sim (Knowledge, playbooks, segredos) | Não |
| **Admin** | Sim | Sim | Sim |

Para um controle de acesso baseado em funções (RBAC) mais detalhado, consulte o [guia de início rápido do Enterprise](/pt-BR/api-reference/getting-started/enterprise-quickstart).

<h2 id="next-steps">
  Próximas etapas
</h2>

* Explore os endpoints da **Organization API** na barra lateral
* Consulte [fluxos comuns](/pt-BR/api-reference/common-flows) para padrões de integração comuns
* Saiba mais sobre [autenticação](/pt-BR/api-reference/authentication) em detalhes
* Configure [automações agendadas](/pt-BR/api-reference/v3/automations/post-organizations-automations) para tarefas recorrentes


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.