Saltar al contenido principal
Esta guía explica cómo migrar integraciones existentes de la API v1 o v2 a las API actuales de Organización y Enterprise. Las API legacy (v1 y v2) seguirán funcionando durante el período de deprecación, pero todas las nuevas funcionalidades solo están disponibles en la API actual.

Qué está cambiando

Paso 1: Crear un usuario de servicio

Reemplaza tu clave de API heredada por un usuario de servicio:
  1. Ve a Settings > API de Devin y abre la pestaña Usuarios de servicio
  2. Haz clic en Provision service user, asigna un rol adecuado y elige una fecha de caducidad (30 días de forma predeterminada)
  3. Copia la clave de API que se muestra tras el aprovisionamiento (empieza con cog_)
  4. 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 organizaciones
  • GET /v3/enterprise/audit-logs — Registros de auditoría
  • GET /v3/enterprise/consumption/* — Datos de uso y facturación
  • GET /v3/enterprise/metrics/* — Métricas de uso
  • GET /v3/enterprise/members/users — Administración de usuarios
  • GET /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:
Consulta Paginación para obtener más detalles.

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 contenido application/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.
Recomendamos migrar a Usuarios de servicio lo antes posible para aprovechar el control de acceso basado en roles, la atribución de sesiones y las nuevas funcionalidades.

¿Necesitas ayuda?

Si tienes problemas durante la migración, ponte en contacto a través de tu canal de soporte habitual de Devin o escríbenos a support@cognition.ai.