Saltar al contenido principal
POST
Crear una nueva sesión
Con los roles predeterminados Miembro y Admin, cualquier clave de API puede llamar a este endpoint. En Enterprise, los roles personalizados o editados deben incluir el permiso Use Devin Sessions (UseDevinSessions). La sesión se crea en nombre del usuario propietario de la clave de API.

Límites y validación

  • prompt debe tener 30,000 caracteres o menos; los prompts más largos devuelven 400.
  • tags admite como máximo 50 etiquetas, y cada una debe ser una cadena no vacía de 256 caracteres como máximo. Las empresas que exigen etiquetas obligatorias rechazan los nombres de etiqueta reservados con un 400.
  • structured_output_schema debe ser un JSON Schema válido (Draft 7) con "type": "object" en la raíz, no contener $ref externos y ocupar como máximo 64 KB; de lo contrario, la solicitud devuelve 400.
  • is_new_session solo se incluye en la respuesta cuando la solicitud usa idempotency_key (o el parámetro deprecado idempotent); de lo contrario, su valor es null.

Autorizaciones

Authorization
string
header
requerido

Clave de API personal (apk_user_*) o clave de API de servicio (apk_*)

Cuerpo

application/json
prompt
string
requerido
idempotent
boolean
predeterminado:false
knowledge_ids
string[] | null

Lista de IDs de Knowledge que se usarán. Si es None, se usa todo Knowledge. Si es una lista vacía, no se usa Knowledge.

max_acu_limit
integer | null

Límite máximo de ACU; debe ser un valor positivo

Rango requerido: x > 0
playbook_id
string | null
secret_ids
string[] | null

Lista de identificadores de secretos que se usarán. Si es None, se usan todos los secretos. Si es una lista vacía, no se usa ningún secreto.

session_secrets
SessionSecretInput · object[] | null

Lista de secretos específicos de la sesión que se usarán. Estos secretos solo están disponibles en esta sesión y no se almacenan entre los secretos de la organización.

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

JSON Schema (Draft 7) para validar la salida estructurada. Máx. 64 KB. Debe ser autocontenido (sin $ref externos).

tags
string[] | null

Lista de etiquetas para agregar a la sesión.

Maximum array length: 50
title
string | null

Título personalizado de la sesión. Si es None, se generará un título automáticamente.

unlisted
boolean
predeterminado:false

Respuesta

Respuesta satisfactoria

Cuerpo de la respuesta que se devuelve cuando una sesión se crea correctamente.

session_id
string
requerido
url
string
requerido
is_new_session
boolean | null