> ## 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.

# Recupera informazioni dettagliate sulla sessione

> Recupera dettagli approfonditi su una sessione specifica, inclusi il conteggio dei messaggi,
la classificazione della dimensione della sessione e l’analisi generata dall’IA.

<Note>
  Il `devin_id` è l'ID della sessione preceduto dal prefisso `devin-` (ad esempio, `devin-abc123`).
</Note>

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

Richiede un utente di servizio con l'autorizzazione `ViewOrgSessions` a livello di organizzazione.


## OpenAPI

````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/sessions/{devin_id}/insights
openapi: 3.1.0
info:
  description: API Devin v3 con autenticazione utente di servizio e RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3/organizations/{org_id}/sessions/{devin_id}/insights:
    get:
      tags:
        - sessions
      summary: Recupera informazioni dettagliate sulla sessione
      description: >-
        Recupera dettagli approfonditi su una sessione specifica, inclusi il
        conteggio dei messaggi,

        la classificazione della dimensione della sessione e l’analisi generata
        dall’IA.
      operationId: >-
        handle_get_session_insights_v3_organizations__org_id__sessions__devin_id__insights_get
      parameters:
        - description: 'ID dell''organizzazione (prefisso: org-)'
          in: path
          name: org_id
          required: true
          schema:
            anyOf:
              - type: string
              - type: 'null'
            example: org-abc123def456
            title: Org Id
        - description: 'ID della sessione Devin (prefisso: 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/SessionInsightsResponse'
          description: Risposta riuscita
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Errore di validazione
components:
  schemas:
    SessionInsightsResponse:
      description: >-
        Dettagli della sessione arricchiti con metriche quantitative e analisi
        AI.


        Estende SessionResponse con campi aggiuntivi che richiedono query
        aggiuntive.
      properties:
        acus_consumed:
          title: Acus Consumed
          type: number
        analysis:
          anyOf:
            - $ref: '#/components/schemas/SessionInsightsAnalysis'
            - type: 'null'
          description: >-
            Analisi della sessione generata dall'IA. Nessuna se l'analisi non è
            stata completata.
        category:
          anyOf:
            - enum:
                - bug_fixing
                - ci_cd_and_devops
                - code_quality_and_security
                - code_review
                - code_review_and_analysis
                - data_and_automation
                - documentation_and_content
                - feature_development
                - migrations_and_upgrades
                - other
                - refactoring_and_optimization
                - research_and_exploration
                - security
                - unit_test_generation
              type: string
            - type: 'null'
          description: >-
            La categoria del caso d'uso assegnata alla sessione, se la
            categorizzazione è stata eseguita. Valorizzato solo negli endpoint
            get/list.
          title: Category
        child_session_ids:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Child Session Ids
        created_at:
          title: Created At
          type: integer
        is_archived:
          default: false
          title: Is Archived
          type: boolean
        num_devin_messages:
          description: Numero di messaggi di Devin inviati durante la sessione.
          title: Num Devin Messages
          type: integer
        num_user_messages:
          description: Numero di messaggi dell’utente inviati durante la sessione.
          title: Num User Messages
          type: integer
        org_id:
          title: Org Id
          type: string
        origin:
          anyOf:
            - enum:
                - webapp
                - slack
                - teams
                - api
                - linear
                - jira
                - automation
                - cli
                - desktop
                - code_scan
                - other
              type: string
            - type: 'null'
          description: L'origine da cui è stata creata la sessione.
          title: Origin
        parent_session_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Parent Session Id
        playbook_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Playbook Id
        pull_requests:
          items:
            $ref: '#/components/schemas/SessionPullRequest'
          title: Pull Requests
          type: array
        service_user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Service User Id
        session_id:
          title: Session Id
          type: string
        session_size:
          description: >-
            Classificazione della dimensione della sessione basata sull’utilizzo
            di ACU e sul numero di messaggi.
          enum:
            - xs
            - s
            - m
            - l
            - xl
          title: Session Size
          type: string
        status:
          enum:
            - new
            - claimed
            - running
            - exit
            - error
            - suspended
            - resuming
          title: Status
          type: string
        status_detail:
          anyOf:
            - enum:
                - working
                - waiting_for_user
                - waiting_for_approval
                - finished
                - inactivity
                - user_request
                - usage_limit_exceeded
                - out_of_credits
                - out_of_quota
                - no_quota_allocation
                - payment_declined
                - org_usage_limit_exceeded
                - total_session_limit_exceeded
                - error
              type: string
            - type: 'null'
          description: >-
            Ulteriore dettaglio sullo stato corrente della sessione. Quando
            status è 'running': 'working' (sta lavorando attivamente),
            'waiting_for_user' (richiede input dell'utente),
            'waiting_for_approval' (in attesa dell'approvazione di un'azione in
            modalità sicura) oppure 'finished' (attività completata). Quando
            status è 'suspended': il motivo della sospensione, ad esempio
            'inactivity', 'user_request', 'usage_limit_exceeded',
            'out_of_credits', 'out_of_quota', 'no_quota_allocation',
            'payment_declined', 'org_usage_limit_exceeded',
            'total_session_limit_exceeded' oppure 'error'. Valorizzato solo
            negli endpoint get/list.
          title: Status Detail
        structured_output:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            Output strutturato validato dalla sessione. Valorizzato solo sugli
            endpoint GET/list.
          title: Structured Output
        subcategory:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Il nome visualizzato della sottocategoria assegnata alla sessione.
            'Other' quando è impostata una categoria ma non è stata assegnata né
            risolta alcuna sottocategoria. Valorizzato solo negli endpoint
            get/list.
          title: Subcategory
        tags:
          items:
            type: string
          title: Tags
          type: array
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        updated_at:
          title: Updated At
          type: integer
        url:
          title: Url
          type: string
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
      required:
        - session_id
        - url
        - status
        - tags
        - org_id
        - created_at
        - updated_at
        - acus_consumed
        - pull_requests
        - num_user_messages
        - num_devin_messages
        - session_size
      title: SessionInsightsResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    SessionInsightsAnalysis:
      description: >-
        Dati di analisi generati dall’IA a seguito dell’analisi di una sessione
        completata.
      properties:
        action_items:
          default: []
          items:
            $ref: '#/components/schemas/SessionInsightsActionItem'
          title: Action Items
          type: array
        classification:
          anyOf:
            - $ref: '#/components/schemas/SessionInsightsClassification'
            - type: 'null'
        issues:
          default: []
          items:
            $ref: '#/components/schemas/SessionInsightsIssue'
          title: Issues
          type: array
        note_usage:
          anyOf:
            - $ref: '#/components/schemas/SessionInsightsNoteUsage'
            - type: 'null'
        suggested_prompt:
          anyOf:
            - $ref: '#/components/schemas/SessionInsightsSuggestedPrompt'
            - type: 'null'
        timeline:
          default: []
          items:
            $ref: '#/components/schemas/SessionInsightsTimelineEvent'
          title: Timeline
          type: array
      title: SessionInsightsAnalysis
      type: object
    SessionPullRequest:
      properties:
        pr_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Pr State
        pr_url:
          title: Pr Url
          type: string
      required:
        - pr_url
        - pr_state
      title: SessionPullRequest
      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
    SessionInsightsActionItem:
      properties:
        action_item:
          title: Action Item
          type: string
        issue_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Issue Id
        type:
          default: other
          enum:
            - machine_setup
            - repo_config
            - knowledge
            - prompt_improvement
            - other
          title: Type
          type: string
      required:
        - action_item
      title: SessionInsightsActionItem
      type: object
    SessionInsightsClassification:
      properties:
        category:
          title: Category
          type: string
        confidence:
          title: Confidence
          type: number
        programming_languages:
          default: []
          items:
            type: string
          title: Programming Languages
          type: array
        tools_and_frameworks:
          default: []
          items:
            type: string
          title: Tools And Frameworks
          type: array
      required:
        - category
        - confidence
      title: SessionInsightsClassification
      type: object
    SessionInsightsIssue:
      properties:
        id:
          default: ''
          title: Id
          type: string
        impact:
          title: Impact
          type: string
        issue:
          title: Issue
          type: string
        label:
          title: Label
          type: string
      required:
        - issue
        - impact
        - label
      title: SessionInsightsIssue
      type: object
    SessionInsightsNoteUsage:
      properties:
        bad_usages:
          default: []
          items:
            $ref: '#/components/schemas/SessionInsightsNoteUsageItem'
          title: Bad Usages
          type: array
        good_usages:
          default: []
          items:
            $ref: '#/components/schemas/SessionInsightsNoteUsageItem'
          title: Good Usages
          type: array
      title: SessionInsightsNoteUsage
      type: object
    SessionInsightsSuggestedPrompt:
      properties:
        feedback_items:
          default: []
          items:
            $ref: '#/components/schemas/SessionInsightsFeedbackItem'
          title: Feedback Items
          type: array
        original_prompt:
          title: Original Prompt
          type: string
        suggested_prompt:
          title: Suggested Prompt
          type: string
      required:
        - original_prompt
        - suggested_prompt
      title: SessionInsightsSuggestedPrompt
      type: object
    SessionInsightsTimelineEvent:
      properties:
        color:
          default: ''
          title: Color
          type: string
        description:
          title: Description
          type: string
        issue_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Issue Id
        title:
          title: Title
          type: string
      required:
        - title
        - description
      title: SessionInsightsTimelineEvent
      type: object
    SessionInsightsNoteUsageItem:
      properties:
        message:
          title: Message
          type: string
        note_id:
          title: Note Id
          type: string
        reason:
          title: Reason
          type: string
      required:
        - reason
        - message
        - note_id
      title: SessionInsightsNoteUsageItem
      type: object
    SessionInsightsFeedbackItem:
      properties:
        details:
          title: Details
          type: string
        excerpt:
          title: Excerpt
          type: string
        issue_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Issue Id
        summary:
          title: Summary
          type: string
      required:
        - summary
        - excerpt
        - details
      title: SessionInsightsFeedbackItem
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
      scheme: bearer
      type: http

````