Pular para o conteúdo principal
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

  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
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: Gerar uma chave de API

  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:
export DEVIN_API_KEY="cog_your_key_here"

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

Crie uma sessão do Devin: 
curl -X POST "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
Você não precisa especificar o ID da sua organização na URL. Como seu usuário de serviço é vinculado a uma única organização, a API o resolve automaticamente. Opcionalmente, você pode incluí-lo: /v3/organizations/{org_id}/sessions. Encontre o ID da sua organização em Settings → Organization details.
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/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/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/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Criar uma entrada de Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/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..."}'

​
Permissões para usuários do Teams

Organizações do Teams têm um modelo de permissões simples:
FunçãoPode criar sessõesPode gerenciar recursosPode gerenciar configurações
MemberSimSim (Knowledge, playbooks, segredos)Não
AdminSimSimSim
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