Qué está cambiando
Paso 1: Crear un usuario de servicio
Reemplaza tu clave de API heredada por un usuario de servicio:- Ve a Settings > API de Devin y abre la pestaña Usuarios de servicio
- Haz clic en Provision service user, asigna un rol adecuado y elige una fecha de caducidad (30 días de forma predeterminada)
- Copia la clave de API que se muestra tras el aprovisionamiento (empieza con
cog_) - Actualiza tu integración para usar la nueva clave
Tus claves de API heredadas seguirán funcionando durante el período de deprecación. Podrás migrar gradualmente.
Paso 2: Actualizar las URL de los endpoints
Endpoints de sesión
Endpoints de Knowledge
Endpoints de playbooks
Los endpoints
/playbooks están deprecados en todas las versiones de la API. Los playbooks se están trasladando a Habilidades. Crea las nuevas instrucciones como skills en la página Personalizar. Las cuentas creadas a partir del 24 de octubre de 2026 que no tengan playbooks reciben un 410 de estos endpoints. Consulta Los playbooks se están trasladando a Habilidades.Endpoints de secretos
Endpoints exclusivos de Enterprise (nuevo)
Estos endpoints no tienen equivalente en v1/v2: solo están disponibles en la versión actual de la API:GET /v3/enterprise/organizations— Listar organizacionesGET /v3/enterprise/audit-logs— Registros de auditoríaGET /v3/enterprise/consumption/*— Datos de uso y facturaciónGET /v3/enterprise/metrics/*— Métricas de usoGET /v3/enterprise/members/users— Administración de usuariosGET /v3/enterprise/roles— Administración de roles- Aprovisionamiento de usuarios de servicio, listas de acceso por IP, límites de ACU y más
Paso 3: Actualizar la paginación
La API actual usa paginación basada en cursor en lugar de paginación basada en desplazamiento:Paso 4: Gestionar los cambios en el formato de la respuesta
Valores de estado de la sesión
La API actual devuelve información de estado más detallada. Consulta la referencia del endpoint para conocer el esquema completo.Respuestas de error
La API actual devuelve los errores en el formato RFC 9457, con el tipo de contenidoapplication/problem+json. El cuerpo incluye los miembros type, title y status, y también puede incluir los miembros detail, instance, errors y error_code.
Las API legacy devuelven un cuerpo JSON con un miembro detail. En las respuestas 422 de la API actual, detail es una cadena y el miembro errors contiene los errores de cada campo.
Cronograma de obsolescencia
Settings > API de Devin muestra las keys legacy en la pestaña claves de API (legacy). Enterprise settings > API de Devin las muestra en la pestaña Legacy API, que incluye un banner de obsolescencia. Durante el período de transición:- Ahora: Las claves de API heredadas siguen funcionando. Es posible que las organizaciones nuevas no tengan acceso a la creación de keys legacy.
- Período de deprecación: Tanto las keys legacy como los tokens de Usuarios de servicio funcionan en paralelo.
- Fin de vida útil: Las claves de API heredadas se eliminarán pronto. Supervisa la configuración de Devin para ver los anuncios.

