> ## 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 sesión > Devuelve detalles centrados en la sesión solicitada dentro del alcance de una organización. ## OpenAPI ````yaml /api-reference/openapi-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 publica REST para portal servers: - url: https://api.staging.flxwvdexternal.com description: Staging API server security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/sessions/{session_id}: get: tags: - Sesiones summary: Recuperar una sesión description: >- Devuelve detalles centrados en la sesión solicitada dentro del alcance de una organización. 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 organizacion. 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 sesion. example: 550E8400-E29B-41D4-A716-446655440000 responses: '200': description: Detalles de la sesion recuperados correctamente. content: application/json: schema: $ref: '#/components/schemas/GetSessionByIdResponseV1' examples: session_details: summary: Respuesta de detalle de la sesion 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: Parametros de solicitud no validos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_session_id: summary: Formato de identificador de sesion no valido 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 autorizado o la organizacion no es accesible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallo de acceso a la organizacion value: error: message: No autorizado code: unauthorized '404': description: >- Sesion no encontrada dentro del alcance autorizado de la organizacion. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: session_not_found: summary: La sesion solicitada no fue encontrada value: error: message: Sesion no encontrada code: not_found '500': description: Error interno del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallo no controlado 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 sesion. user_name: type: string description: Cuenta de usuario para la sesion. session_type: type: string enum: - vdi_desktop - application - sdi_desktop - device description: Tipo de sesion. windows_session_id: type: integer description: Identificador de sesion de Windows. connection_state: type: string enum: - unknown - connected - disconnected - terminated - preparing_session - active - reconnecting - non_broker_session - other - pending description: Estado de conexion de la sesion. start_date: type: string description: Marca de tiempo de inicio de la sesion. session_status: type: string nullable: true enum: - empty - active_notifications - active_notifications_ack_accepted - active_notifications_ack_pending description: Estado de la sesion. platform_type: type: string enum: - windows - mac - linux - android - chrome_os - unknown description: Tipo de plataforma. connected: type: boolean description: Indica si la sesion esta conectada actualmente. current_session_id: type: integer description: Identificador actual de la sesion de conexion. current_dc_name: type: string description: Nombre actual del centro de datos. last_connection_time: type: string description: Cadena de marca de tiempo de la ultima conexion. log_on_duration: type: number description: Duracion de inicio de sesion. 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: Clave de sesion. flexx_analyzer_executed: type: boolean description: Indica si la ejecucion del analizador se ha completado. cpu_usage: type: number nullable: true description: Uso actual de CPU. ram_usage_gb: type: number nullable: true description: Uso actual de RAM en gigabytes. rtt_usage: type: number nullable: true description: Uso actual de RTT. current_uid_usage: type: number nullable: true description: Uso actual de UID. ram_usage: type: number nullable: true description: Uso actual de RAM. ram_percentage: type: number nullable: true description: Porcentaje actual de uso de RAM. number_alerts_user: type: number nullable: true description: Numero de alertas de usuario. number_alerts_vm: type: number nullable: true description: Numero de alertas de Workspace. workspace_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Identificador MongoDB (_id) del Workspace relacionado con la sesion, resuelto a partir de la relación de sesión. 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 ````