> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar insights de la sesión

> Activa la generación bajo demanda de insights de la sesión.

Devuelve ``already_exists`` si los insights ya se han generado.
De lo contrario, inicia la generación en segundo plano. Consulta el
endpoint GET de insights para recuperar los resultados una vez que finalice la generación.

<Note>
  El `devin_id` es el ID de la sesión precedido por `devin-` (p. ej., `devin-abc123`).
</Note>

<div id="permissions">
  ## Permisos
</div>

Requiere un usuario de servicio con el permiso `ManageOrgSessions` a nivel de la organización.

<div id="behavior">
  ## Comportamiento
</div>

* Si los insights ya se generaron (o la generación está en curso), el endpoint devuelve `{ "status": "already_exists" }` sin volver a iniciarla.
* Si no hay insights (o el último intento falló), el endpoint inicia la generación en segundo plano y devuelve `{ "status": "started" }`.
* Consulta el endpoint [GET session insights](/es/api-reference/v3/sessions/get-organizations-session-insights) para recuperar los resultados una vez que se complete la generación.


## OpenAPI

````yaml es/v3-openapi.yaml POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate
openapi: 3.1.0
info:
  description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate:
    post:
      tags:
        - sessions
      summary: Generar insights de la sesión
      description: >-
        Activa la generación bajo demanda de insights de la sesión.


        Devuelve ``already_exists`` si los insights ya se han generado.

        De lo contrario, inicia la generación en segundo plano. Consulta el

        endpoint GET de insights para recuperar los resultados una vez que
        finalice la generación.
      operationId: >-
        handle_generate_session_insights_v3_organizations__org_id__sessions__devin_id__insights_generate_post
      parameters:
        - description: 'ID de la organización (prefijo: org-)'
          in: path
          name: org_id
          required: true
          schema:
            anyOf:
              - type: string
              - type: 'null'
            example: org-abc123def456
            title: Org Id
        - description: 'ID de sesión de Devin (prefijo: devin-)'
          in: path
          name: devin_id
          required: true
          schema:
            anyOf:
              - type: string
              - type: 'null'
            example: devin-abc123def456
            title: Devin Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionInsightsGenerateResponse'
          description: Respuesta satisfactoria
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Prohibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No encontrado
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflicto
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenido no procesable
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Demasiadas solicitudes
components:
  schemas:
    SessionInsightsGenerateResponse:
      description: Respuesta al activar la generación de insights de la sesión.
      properties:
        session_id:
          description: El ID de sesión para el que se activó la generación de insights.
          title: Session Id
          type: string
        status:
          description: El estado de la solicitud de generación.
          title: Status
          type: string
      required:
        - session_id
        - status
      title: SessionInsightsGenerateResponse
      type: object
    ProblemDetail:
      description: >-
        Cuerpo de error RFC 9457 application/problem+json para la API v3.


        detail se conserva del cuerpo heredado {"detail": ...} por
        compatibilidad con versiones anteriores; los

        otros miembros son adicionales. errors contiene errores de validación

        a nivel de campo (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Explicación legible para humanos específica de esta ocurrencia.
          title: Detail
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errores de validación por campo (solo en respuestas 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
          title: Instance
        status:
          description: El código de estado HTTP.
          title: Status
          type: integer
        title:
          description: Un breve resumen del tipo de problema, legible para humanos.
          title: Title
          type: string
        type:
          default: about:blank
          description: Una referencia URI que identifica el tipo de problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credencial de usuario de servicio (prefijo: cog_)'
      scheme: bearer
      type: http

````