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

# Visão geral da API v1 (legado)

> Gerenciamento principal de sessões e automação com acesso no escopo da organização

<Warning>
  Esta versão da API está descontinuada. Use a [API v3](/pt-BR/api-reference/v3/overview) com autenticação de usuário de serviço. Consulte o [guia de migração](/pt-BR/api-reference/getting-started/migration-guide) para obter instruções passo a passo.
</Warning>

A API v1 fornece as funcionalidades principais para criar e gerenciar sessões do Devin, juntamente com recursos de suporte como segredos, Knowledge e playbooks.

**URL base:** `https://api.devin.ai/v1/*`

**Autenticação:** Chaves de API pessoais ou de serviço ([saiba mais](/pt-BR/api-reference/authentication))

<div id="permissions">
  ## Permissões
</div>

A API v1 usa autenticação com escopo de organização. As chaves de API são vinculadas a um par específico `(org_id, user_id)` e fornecem acesso aos recursos dentro dessa organização. A API v1 não usa o sistema completo de permissões RBAC — o acesso é determinado pelo escopo de organização da chave de API.

Para um controle de RBAC mais granular, use a [Organization API](/pt-BR/api-reference/v3/overview) em vez disso.

<div id="sessions">
  ## Sessões
</div>

Gerencie sessões do Devin e interaja com elas:

<CardGroup cols={2}>
  <Card title="Listar sessões" icon="list" href="/pt-BR/api-reference/v1/sessions/list-sessions">
    Liste todas as sessões atuais do Devin na sua organização
  </Card>

  <Card title="Criar uma sessão" icon="plus" href="/pt-BR/api-reference/v1/sessions/create-a-new-devin-session">
    Inicie uma nova sessão do Devin com uma descrição de tarefa e parâmetros opcionais
  </Card>

  <Card title="Obter detalhes da sessão" icon="circle-info" href="/pt-BR/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    Obtenha informações sobre o status e o resultado de uma sessão existente
  </Card>

  <Card title="Enviar mensagem" icon="message" href="/pt-BR/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    Interaja com uma sessão ativa enviando mensagens para o Devin
  </Card>

  <Card title="Enviar arquivos" icon="upload" href="/pt-BR/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    Envie arquivos para o Devin usar durante as sessões
  </Card>

  <Card title="Atualizar tags da sessão" icon="tags" href="/pt-BR/api-reference/v1/sessions/update-session-tags">
    Atualize as tags associadas a uma sessão do Devin
  </Card>
</CardGroup>

<div id="secrets">
  ## Segredos
</div>

Gerencie segredos e credenciais da sua organização:

<CardGroup cols={2}>
  <Card title="Listar segredos" icon="key" href="/pt-BR/api-reference/v1/secrets/list-secrets">
    Veja os metadados de todos os segredos da sua organização
  </Card>

  <Card title="Excluir segredo" icon="trash" href="/pt-BR/api-reference/v1/secrets/delete-secret">
    Remova permanentemente um segredo da sua organização
  </Card>
</CardGroup>

<div id="knowledge">
  ## Knowledge
</div>

Gerencie o Knowledge da sua organização:

<CardGroup cols={2}>
  <Card title="Listar Knowledge" icon="list" href="/pt-BR/api-reference/v1/knowledge/list-knowledge">
    Liste todos os itens de Knowledge e as pastas da sua organização
  </Card>

  <Card title="Criar Knowledge" icon="plus" href="/pt-BR/api-reference/v1/knowledge/create-knowledge">
    Crie um novo item de Knowledge
  </Card>

  <Card title="Atualizar Knowledge" icon="pencil" href="/pt-BR/api-reference/v1/knowledge/update-knowledge">
    Atualize um item de Knowledge
  </Card>

  <Card title="Excluir Knowledge" icon="trash" href="/pt-BR/api-reference/v1/knowledge/delete-knowledge">
    Exclua um item de Knowledge
  </Card>
</CardGroup>

<div id="playbooks">
  ## Playbooks
</div>

Gerencie conjuntos de instruções reutilizáveis para sua organização:

<CardGroup cols={2}>
  <Card title="Listar Playbooks" icon="list" href="/pt-BR/api-reference/v1/playbooks/list-playbooks">
    Visualize todos os playbooks disponíveis para sua organização
  </Card>

  <Card title="Criar Playbook" icon="plus" href="/pt-BR/api-reference/v1/playbooks/create-playbook">
    Crie um novo playbook de equipe com instruções e uma macro opcional
  </Card>

  <Card title="Obter Playbook" icon="circle-info" href="/pt-BR/api-reference/v1/playbooks/get-playbook">
    Obtenha os detalhes de um playbook específico
  </Card>

  <Card title="Atualizar Playbook" icon="pencil" href="/pt-BR/api-reference/v1/playbooks/update-playbook">
    Atualize um playbook de equipe existente
  </Card>

  <Card title="Excluir Playbook" icon="trash" href="/pt-BR/api-reference/v1/playbooks/delete-playbook">
    Exclua um playbook de equipe da sua organização
  </Card>
</CardGroup>

<div id="next-steps">
  ## Próximos passos
</div>

Migre para a [API atual](/pt-BR/api-reference/overview) para RBAC, atribuição de sessões e novos recursos. Consulte o [guia de migração](/pt-BR/api-reference/getting-started/migration-guide).