Início rápido: Equipes

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.

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.

Etapa 1: Criar um usuário de serviço

Acesse Settings > Devin API na sua organização e abra a aba Usuários de serviço
Clique em Provision usuário de serviço
Escolha um nome de exibição descritivo (por exemplo, “CI Pipeline”, “Monitoring Bot”)
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

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.

Etapa 2: Copie sua chave de API

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

export DEVIN_API_KEY="cog_your_key_here"

Etapa 3: Faça sua primeira chamada à API

Crie uma sessão do Devin:

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

Encontre o ID da sua organização no topo da página Settings → Devin API.

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 para mais detalhes.

Passo 4: Operações comuns

Liste suas sessões

curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Enviar uma mensagem para uma sessão ativa

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

Gerenciar o Knowledge

# 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..."}'

Permissões para usuários do Teams

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.

Próximas etapas

Explore os endpoints da Organization API na barra lateral
Consulte fluxos comuns para padrões de integração comuns
Saiba mais sobre autenticação em detalhes
Configure automações agendadas para tarefas recorrentes

Primeiros passos

Conceitos

Ciclo de vida do agente

Gerenciamento de contexto

Gerenciamento de ambiente

Automação

Integrações

Análises

Observabilidade

Devin para Security

Infraestrutura

Identidade e acesso

Configuração

API legada v1

API legada v2

Início rápido: Equipes

Etapa 1: Criar um usuário de serviço

Etapa 2: Copie sua chave de API

Etapa 3: Faça sua primeira chamada à API

Passo 4: Operações comuns

Liste suas sessões

Enviar uma mensagem para uma sessão ativa

Gerenciar o Knowledge

Permissões para usuários do Teams

Próximas etapas

​Etapa 1: Criar um usuário de serviço

​Etapa 2: Copie sua chave de API

​Etapa 3: Faça sua primeira chamada à API

​Passo 4: Operações comuns

​Liste suas sessões

​Enviar uma mensagem para uma sessão ativa

​Gerenciar o Knowledge

​Permissões para usuários do Teams

​Próximas etapas

Etapa 1: Criar um usuário de serviço

Etapa 2: Copie sua chave de API

Etapa 3: Faça sua primeira chamada à API

Passo 4: Operações comuns

Liste suas sessões

Enviar uma mensagem para uma sessão ativa

Gerenciar o Knowledge

Permissões para usuários do Teams

Próximas etapas