> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/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
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Error de validación
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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credencial de usuario de servicio (prefijo: cog_)'
      scheme: bearer
      type: http

````