Pular para o conteúdo principal
POST
Criar nova sessão
Com as funções padrão de Membro e Administrador, qualquer chave de API pode chamar este endpoint. No Enterprise, uma função personalizada ou editada precisa incluir a permissão Usar sessões do Devin (UseDevinSessions). A sessão é criada em nome do usuário a quem a chave de API pertence.

Limites e validação

  • prompt deve ter no máximo 30,000 caracteres; prompts mais longos retornam 400.
  • tags aceita no máximo 50 marcadores, cada um deles uma string não vazia com no máximo 256 caracteres. Contas Enterprise que impõem marcadores obrigatórios rejeitam nomes de marcadores reservados com 400.
  • structured_output_schema deve ser um JSON Schema válido (Draft 7) com "type": "object" na raiz, sem $ref externos e com no máximo 64 KB; caso contrário, a requisição retorna 400.
  • is_new_session na resposta só é preenchido quando a requisição usa idempotency_key (ou o parâmetro obsoleto idempotent); caso contrário, é null.

Autorizações

Authorization
string
header
obrigatório

Chave de API pessoal (apk_user_*) ou chave de API de serviço (apk_*)

Corpo

application/json
prompt
string
obrigatório
idempotent
boolean
padrão:false
knowledge_ids
string[] | null

Lista de IDs de Knowledge a serem usados. Se for None, use todo o Knowledge. Se for uma lista vazia, não use nenhum Knowledge.

max_acu_limit
integer | null

Limite máximo de ACU; deve ser um valor positivo

Intervalo obrigatório: x > 0
playbook_id
string | null
secret_ids
string[] | null

Lista de IDs de segredos a utilizar. Se for None, use todos os segredos. Se for uma lista vazia, não use nenhum segredo.

session_secrets
SessionSecretInput · object[] | null

Lista de segredos específicos da sessão para uso. Esses segredos ficam disponíveis apenas nesta sessão e não são armazenados nos segredos da organização.

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

JSON Schema (Draft 7) para validar saídas estruturadas. Máx. 64 KB. Deve ser autocontido (sem $ref externo).

tags
string[] | null

Lista de tags a serem adicionadas à sessão.

Maximum array length: 50
title
string | null

Título personalizado para a sessão. Se for None, um título será gerado automaticamente.

unlisted
boolean
padrão:false

Resposta

Resposta bem-sucedida

Corpo da resposta retornado quando uma sessão é criada com sucesso.

session_id
string
obrigatório
url
string
obrigatório
is_new_session
boolean | null