Skip to main content
A API do Devin permite que você integre o Devin às suas aplicações, automatize fluxos de trabalho e crie ferramentas poderosas. Use usuários de serviço com controle de acesso baseado em função (RBAC) para obter acesso seguro e auditável à API.

​
Primeiros passos

Início rápido do Teams

Para equipes e organizações padrão. Crie um usuário de serviço e faça sua primeira chamada de API em minutos.

Início rápido do Enterprise

Para clientes Enterprise com RBAC, suporte a múltiplas organizações e permissões avançadas.
Qual opção devo escolher? A maioria dos clientes deve começar pelo início rápido do Teams. Escolha Enterprise se você gerencia várias organizações, usa SSO ou precisa de funções personalizadas e RBAC.

​
Estrutura da API

A API é organizada em dois escopos:

​
Organization API

URL base: https://api.devin.ai/v3/organizations/* Para gerenciar recursos dentro de uma única organização — sessões, Knowledge, playbooks, segredos e muito mais. É aqui que a maioria das integrações se inicia.

​
Enterprise API

URL base: https://api.devin.ai/v3/enterprise/* Para gerenciamento entre organizações — análises, logs de auditoria, gerenciamento de usuários, faturamento e infraestrutura. Disponível para clientes Enterprise. Ambos os escopos usam credenciais de usuário de serviço (prefixo cog_). Consulte Authentication para configuração.

​
Atribuição de sessão

Usuários de serviço são identidades separadas de usuários humanos, mas você pode criar sessões em nome de qualquer usuário na sua organização usando o parâmetro create_as_user_id. Isso faz com que as sessões apareçam na lista de sessões desse usuário e contem para o uso desse usuário — exatamente como se ele mesmo as tivesse criado.
Você usava chaves de API pessoais? Nas versões v1/v2, chaves de API pessoais criavam sessões automaticamente com o seu usuário. Na v3, use um usuário de serviço + create_as_user_id para o mesmo comportamento — com o benefício adicional de RBAC, registros de auditoria e gerenciamento centralizado de chaves. A função do usuário de serviço deve incluir a permissão ImpersonateOrgSessions.
Você também pode se autenticar diretamente como o seu usuário com um Personal Access Token — sem precisar de usuário de serviço ou create_as_user_id. As sessões são automaticamente atribuídas a você.
Você pode encontrar IDs de usuário por meio do endpoint List organization users (beta, usuário de serviço com escopo de organização) ou do endpoint List users do Enterprise. Ambos retornam apenas usuários com atribuições diretas de função. Para usuários cuja associação vem de grupos de IDP, use List organization IDP group users ou seu equivalente no Enterprise.

​
APIs legadas (v1 e v2)

As APIs v1 e v2 continuam funcionando durante o período de descontinuação, mas não recebem novos recursos. Recomendamos migrar para a API atual para controle de acesso baseado em funções, atribuição de sessões e novas capacidades.

​
Tratamento de erros

Todas as APIs usam códigos de status HTTP padrão:
  • 200 OK: Solicitação bem-sucedida
  • 201 Created: Recurso criado com sucesso
  • 400 Bad Request: Parâmetros inválidos na solicitação
  • 401 Unauthorized: Chave de API ausente ou inválida
  • 403 Forbidden: Permissões insuficientes
  • 404 Not Found: Recurso não encontrado
  • 429 Too Many Requests: Limite de requisições excedido
  • 500 Internal Server Error: Erro no servidor

​
Suporte

Em caso de dúvidas sobre a API ou para relatar problemas, envie um e-mail para support@cognition.ai.