Pular para o conteúdo principal
DELETE
Encerrar sessão
O devin_id é o ID da sessão prefixado com devin- (por exemplo, devin-abc123).

Permissões

Requer um usuário de serviço ou um token de acesso pessoal que pertença à organização e possa gerenciar a sessão de destino. O chamador pode gerenciar uma sessão se atender a qualquer uma das condições a seguir:
  • Ter criado a sessão.
  • Ter uma concessão session.configure na sessão.
  • Ter a permissão ManageOrgSessions no nível da organização.
A permissão ManageOrgSessions só é necessária para encerrar sessões que o usuário de serviço não criou e nas quais não tem uma concessão session.configure.

Observações

Depois de encerrada, uma sessão não pode ser retomada. Sessões encerradas continuam disponíveis para consulta, sejam arquivadas ou não. Defina o parâmetro archive como true para também arquivar a sessão e suas sessões descendentes. O arquivamento as marca como arquivadas (is_archived: true) e coloca em suspensão todas as descendentes em execução, mas não preserva nenhum dado adicional. Consulte Arquivar sessão para mais detalhes.

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

org_id
string | null
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

devin_id
string | null
obrigatório

ID da sessão do Devin (prefixo: devin-)

Exemplo:

"devin-abc123def456"

Parâmetros de consulta

archive
boolean
padrão:false

Se a sessão do Devin deve ser arquivada

Resposta

Resposta bem-sucedida

session_id
string
obrigatório
url
string
obrigatório
status
enum<string>
obrigatório
Opções disponíveis:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
obrigatório
org_id
string | null
obrigatório

Organização proprietária. Null para sessões desvinculadas, que pertencem à conta de seu criador, e não a uma organização.

created_at
integer
obrigatório
updated_at
integer
obrigatório
acus_consumed
number
obrigatório
pull_requests
SessionPullRequest · object[]
obrigatório
title
string | null
playbook_id
string | null
user_id
string | null
is_archived
boolean
padrão:false
parent_session_id
string | null
child_session_ids
string[] | null
service_user_id
string | null
category
enum<string> | null

A categoria de caso de uso atribuída à sessão, se a categorização tiver sido executada. Preenchido apenas nos endpoints get/list.

Opções disponíveis:
bug_fixing,
ci_cd_and_devops,
code_quality_and_security,
code_review,
code_review_and_analysis,
data_and_automation,
documentation_and_content,
feature_development,
migrations_and_upgrades,
other,
production_investigation,
refactoring_and_optimization,
research_and_exploration,
security,
unit_test_generation
subcategory
string | null

O nome de exibição da subcategoria atribuída à sessão. 'Other' quando uma categoria está definida, mas nenhuma subcategoria foi atribuída ou resolvida. Preenchido apenas nos endpoints get/list.

origin
enum<string> | null

A origem em que a sessão foi criada.

Opções disponíveis:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
automation_id
string | null

ID da automação que criou esta sessão, se houver.

structured_output
Structured Output · object | null

Saída estruturada validada da sessão. Preenchido apenas nos endpoints get/list.

devin_mode
enum<string> | null

O modo Agent do Devin com o qual a sessão foi criada, após aplicar os padrões da organização/do usuário e a herança da sessão pai. Nenhum quando a sessão executa uma prévia do agente que não tem um modo equivalente.

Opções disponíveis:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
status_detail
enum<string> | null

Detalhe adicional sobre o status atual da sessão. Quando o status é 'running': 'working' (trabalhando ativamente), 'waiting_for_user' (precisa de entrada do usuário), 'waiting_for_approval' (aguardando aprovação de ação no modo seguro) ou 'finished' (tarefa concluída). Quando o status é 'suspended': o motivo da suspensão, como 'inactivity', 'user_request', 'usage_limit_exceeded', 'out_of_credits', 'out_of_quota', 'no_quota_allocation', 'payment_declined', 'org_usage_limit_exceeded', 'user_usage_limit_exceeded', 'total_session_limit_exceeded', 'contract_expired' ou 'error'. Preenchido apenas nos endpoints get/list.

Opções disponíveis:
working,
waiting_for_user,
waiting_for_approval,
finished,
inactivity,
user_request,
usage_limit_exceeded,
out_of_credits,
out_of_quota,
no_quota_allocation,
payment_declined,
org_usage_limit_exceeded,
user_usage_limit_exceeded,
total_session_limit_exceeded,
contract_expired,
error
on_demand_usage
number | null

Gasto sob demanda (excedente) em USD nesta sessão, excluindo sessões filhas. Preenchido apenas para planos Teams; 0 quando a sessão foi totalmente coberta pela cota. Omitido para outros planos. Preenchido apenas nos endpoints get/list.

security_profile
SessionSecurityProfileResponse · object | null

A vinculação da própria sessão a um perfil de segurança. Preenchido apenas nos endpoints get/list.