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

# Recuperar una sessió

> Torna detalls centrats en la sessió sol·licitada dins l'abast d'una organització.



## OpenAPI

````yaml /ca/api-reference/openapi.ca-v1.json get /v1/organizations/{organization_id}/sessions/{session_id}
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 1.0.0
  description: API pública REST per al portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/sessions/{session_id}:
    get:
      tags:
        - Sessions
      summary: Recuperar una sessió
      description: >-
        Torna detalls centrats en la sessió sol·licitada dins l'abast d'una
        organització.
      operationId: get_session_by_id
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador de la organització.
          example: 507f1f77bcf86cd799439011
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            pattern: ^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$
            minLength: 36
            maxLength: 36
          description: Identificador de la sessió.
          example: 550E8400-E29B-41D4-A716-446655440000
      responses:
        '200':
          description: Detalls de la sessió recuperats correctament.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSessionByIdResponseV1'
              examples:
                session_details:
                  summary: Resposta de detall de la sessió
                  value:
                    id: 550E8400-E29B-41D4-A716-446655440000
                    user_name: contoso\jdoe
                    session_type: vdi_desktop
                    windows_session_id: 7
                    connection_state: active
                    start_date: '2026-03-15T08:30:00Z'
                    session_status: active_notifications
                    platform_type: windows
                    connected: true
                    current_session_id: 41
                    current_dc_name: dc-eu-01
                    last_connection_time: '2026-03-15T09:45:11Z'
                    log_on_duration: 35
                    session_key: 6BA7B810-9DAD-11D1-80B4-00C04FD430C8
                    flexx_analyzer_executed: true
                    cpu_usage: 34.2
                    ram_usage_gb: 3.8
                    rtt_usage: 18.1
                    current_uid_usage: 2.4
                    ram_usage: 3891
                    ram_percentage: 47
                    number_alerts_user: 0
                    number_alerts_vm: 1
                    workspace_id: 64f0c2a1b2d3e4f5060708aa
        '400':
          description: Paràmetres de solicitud no vàlids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_session_id:
                  summary: Format d'identificador de sessió no vàlid
                  value:
                    error:
                      message: Formato de session_id no valido
                      code: bad_request
                      details: >-
                        session_id debe ser un UUID en mayusculas con formato
                        8-4-4-4-12
        '401':
          description: No autoritzat o l'organització no és accessible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                organization_not_authorized:
                  summary: Fallada d'accés a l'organització
                  value:
                    error:
                      message: No autorizado
                      code: unauthorized
        '404':
          description: Sessió no trobada dins el abast autoritzat de l'organització.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                session_not_found:
                  summary: La sessió sol·licitada no va ser trobada
                  value:
                    error:
                      message: Sesion no encontrada
                      code: not_found
        '500':
          description: Error intern del servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unexpected_error:
                  summary: Fallada inesperada
                  value:
                    error:
                      message: Error interno del servidor
                      code: internal_error
components:
  schemas:
    GetSessionByIdResponseV1:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: ^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$
          minLength: 36
          maxLength: 36
          description: Identificador de la sessió.
        user_name:
          type: string
          description: Compte d'usuari per a la sessió.
        session_type:
          type: string
          enum:
            - vdi_desktop
            - application
            - sdi_desktop
            - device
          description: Tipus de sessió.
        windows_session_id:
          type: integer
          description: Identificador de sessió de Windows.
        connection_state:
          type: string
          enum:
            - unknown
            - connected
            - disconnected
            - terminated
            - preparing_session
            - active
            - reconnecting
            - non_broker_session
            - other
            - pending
          description: Estat de connexió de la sessió.
        start_date:
          type: string
          description: Marca de temps d'inici de la sessió.
        session_status:
          type: string
          nullable: true
          enum:
            - empty
            - active_notifications
            - active_notifications_ack_accepted
            - active_notifications_ack_pending
          description: Estat de la sessió.
        platform_type:
          type: string
          enum:
            - windows
            - mac
            - linux
            - android
            - chrome_os
            - unknown
          description: Tipus de plataforma.
        connected:
          type: boolean
          description: Indica si la sessió està connectada actualment.
        current_session_id:
          type: integer
          description: Identificador actual de la sessió de connexió.
        current_dc_name:
          type: string
          description: Nom actual del centre de dades.
        last_connection_time:
          type: string
          description: Cadena de marca de temps de la última connexió.
        log_on_duration:
          type: number
          description: Durada d'inici de sessió.
        session_key:
          type: string
          format: uuid
          pattern: ^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$
          minLength: 36
          maxLength: 36
          description: Clau de sessió.
        flexx_analyzer_executed:
          type: boolean
          description: Indica si l'execució de l'analitzador s'ha completat.
        cpu_usage:
          type: number
          nullable: true
          description: Ús actual de CPU.
        ram_usage_gb:
          type: number
          nullable: true
          description: Ús actual de RAM en gigabytes.
        rtt_usage:
          type: number
          nullable: true
          description: Ús actual de RTT.
        current_uid_usage:
          type: number
          nullable: true
          description: Ús actual de UID.
        ram_usage:
          type: number
          nullable: true
          description: Ús actual de RAM.
        ram_percentage:
          type: number
          nullable: true
          description: Percentatge actual d'ús de RAM.
        number_alerts_user:
          type: number
          nullable: true
          description: Nombre d'alertes de l'usuari.
        number_alerts_vm:
          type: number
          nullable: true
          description: Nombre d'alertes del Workspace.
        workspace_id:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: >-
            Identificador MongoDB (_id) del Workspace relacionat amb la sessió,
            resolt a partir de la relació de sessió.
      required:
        - id
        - user_name
        - session_type
        - windows_session_id
        - connection_state
        - start_date
        - current_session_id
        - current_dc_name
        - last_connection_time
        - log_on_duration
        - session_key
        - connected
        - flexx_analyzer_executed
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````