Skip to main content
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

acus_consumed
number
obrigatório
created_at
integer
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.

pull_requests
SessionPullRequest · object[]
obrigatório
session_id
string
obrigatório
status
enum<string>
obrigatório
Opções disponíveis:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
obrigatório
updated_at
integer
obrigatório
url
string
obrigatório
automation_id
string | null

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

category
enum<string> | null

A categoria de caso de uso atribuída à sessão, se a categorização tiver sido executada. Preenchida 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
child_session_ids
string[] | null
devin_mode
enum<string> | null

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

Opções disponíveis:
normal,
fast,
fusion,
lite,
ultra,
swe-2-medium,
swe-2-high,
swe-2-max
is_archived
boolean
padrão:false
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.

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
parent_session_id
string | null
playbook_id
string | null
security_profile
SessionSecurityProfileResponse · object | null

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

service_user_id
string | null
status_detail
enum<string> | null

Detalhe adicional sobre o status atual da sessão. Quando o status é 'running': 'working' (trabalhando ativamente), 'waiting_for_user' (requer entrada do usuário), 'waiting_for_approval' (aguardando aprovação da 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
structured_output
Structured Output · object | null

Saída estruturada validada da sessão. Preenchido apenas em endpoints GET/list.

subcategory
string | null

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

title
string | null
user_id
string | null