> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/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>

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

1. Acesse **Settings > Service users** na sua organização
2. Clique em **Create service user**
3. Escolha um nome descritivo (por exemplo, "CI Pipeline", "Monitoring Bot")
4. Selecione uma função:
   * **Admin** — acesso total para gerenciar sessões, Knowledge, playbooks, segredos e configurações
   * **Member** — pode criar e gerenciar sessões do Devin e visualizar recursos

<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>

<div id="step-2-generate-an-api-key">
  ## Etapa 2: Gerar uma chave de API
</div>

1. Após criar o usuário de serviço, clique em **Generate API key**
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"
```

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

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 na página **Settings → Service Users**.
</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>

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

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

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

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

```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"}'
```

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

```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_description": "When writing code", "body": "Use TypeScript strict mode..."}'
```

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

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).

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

* 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 [sessões agendadas](/pt-BR/api-reference/v3/schedules/organizations-schedules) para tarefas recorrentes