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

# Obtener microservicio por identificador

> Devuelve un microservicio visible para la organizacion objetivo (designer o marketplace), con estado de habilitacion y configuracion habilitada cuando exista.



## OpenAPI

````yaml /api-reference/openapi-v1.json get /v1/organizations/{organization_id}/microservices/{microservice_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}/microservices/{microservice_id}:
    get:
      tags:
        - Microservicios
      summary: Obtener microservicio por identificador
      description: >-
        Devuelve un microservicio visible para la organizacion objetivo
        (designer o marketplace), con estado de habilitacion y configuracion
        habilitada cuando exista.
      operationId: get_microservice_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 sobre la que se consulta el
            microservicio.
          example: 507f1f77bcf86cd799439011
        - name: microservice_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador del microservicio a recuperar.
          example: 65f0d9f2b3c4d5e6f7080911
        - name: Accept-Language
          in: header
          required: false
          schema:
            type: string
            default: es-ES
            maxLength: 10
          description: >-
            Idioma para resolver campos multilenguaje a un unico valor por
            campo.
          example: es-ES
      responses:
        '200':
          description: Microservicio recuperado correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMicroserviceByIdResponseV1'
              examples:
                microservicio_habilitado:
                  summary: Microservicio encontrado con configuracion habilitada
                  value:
                    data:
                      id: 65f0d9f2b3c4d5e6f7080911
                      organization_id: 507f1f77bcf86cd799439011
                      name: Antivirus Scan
                      description: Escaneo programado de antivirus
                      category: security
                      created_at: '2026-05-15T10:00:00Z'
                      archived_at: null
                      type: standard
                      context: organization
                      is_ai_enhanced: false
                      enabled: true
                      enabled_configuration:
                        enabled_at: '2026-05-15T10:30:00Z'
                        efficiency: 95
                        workspace_group_execution: l1
                        individual_execution: l3
                        end_user_execution_workspace_group_ids:
                          - 65f0d9f2b3c4d5e6f7080931
                          - 65f0d9f2b3c4d5e6f7080932
                microservicio_no_habilitado:
                  summary: Microservicio encontrado sin configuracion habilitada
                  value:
                    data:
                      id: 65f0d9f2b3c4d5e6f7080912
                      organization_id: 507f1f77bcf86cd799439011
                      name: Patch Baseline
                      description: Control de parches pendientes
                      category: maintenance
                      created_at: '2026-05-16T12:00:00Z'
                      archived_at: null
                      type: standard
                      context: organization
                      is_ai_enhanced: true
                      enabled: false
                      enabled_configuration: null
        '400':
          description: Parametros de solicitud invalidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                id_invalido:
                  summary: Identificador de microservicio invalido
                  value:
                    error:
                      message: Parametro microservice_id invalido
                      code: bad_request
        '401':
          description: No autorizado o sin acceso a la organizacion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                organization_not_authorized:
                  summary: Acceso a organizacion no autorizado
                  value:
                    error:
                      message: No autorizado
                      code: unauthorized
        '404':
          description: >-
            Microservicio no encontrado en el alcance autorizado de la
            organizacion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                microservice_not_found:
                  summary: Microservicio no encontrado
                  value:
                    error:
                      message: No encontrado
                      code: not_found
        '500':
          description: Error interno del servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unexpected_error:
                  summary: Error no controlado
                  value:
                    error:
                      message: Error interno del servidor
                      code: internal_error
components:
  schemas:
    GetMicroserviceByIdResponseV1:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MicroserviceItemV1'
      required:
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
    MicroserviceItemV1:
      type: object
      properties:
        id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador del microservicio.
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador de la organización asociada al microservicio.
        name:
          type: string
          description: Nombre del microservicio resuelto en el idioma solicitado.
        description:
          type: string
          description: Descripción del microservicio resuelta en el idioma solicitado.
        category:
          type: string
          description: Categoría del microservicio resuelta en el idioma solicitado.
        created_at:
          type: string
          format: date-time
          description: Fecha y hora de creación del microservicio.
        archived_at:
          type: string
          format: date-time
          nullable: true
          description: Fecha y hora de archivado, cuando aplique.
        type:
          type: string
          enum:
            - standard
            - condition
          nullable: true
          description: Tipo funcional del microservicio.
        context:
          type: string
          nullable: true
          description: Contexto de visibilidad del microservicio.
        is_ai_enhanced:
          type: boolean
          nullable: true
          description: Indica si el microservicio tiene capacidades de IA habilitadas.
        enabled:
          type: boolean
          description: Indica si el microservicio está habilitado para la organización.
        enabled_configuration:
          type: object
          nullable: true
          description: Configuración habilitada del microservicio para la organización.
          properties:
            enabled_at:
              type: string
              format: date-time
              nullable: true
              description: Fecha y hora en la que se habilitó la configuración.
            efficiency:
              type: number
              description: Valor de eficiencia de la configuración habilitada.
            workspace_group_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Modo de ejecución por grupos de workspace.
            individual_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Modo de ejecución individual.
            end_user_execution_workspace_group_ids:
              type: array
              items:
                type: string
                pattern: ^[0-9a-f]{24}$
                minLength: 24
                maxLength: 24
              description: >-
                Identificadores de grupos de workspace habilitados para
                ejecución de usuario final.
          required:
            - enabled_at
            - efficiency
            - workspace_group_execution
            - individual_execution
            - end_user_execution_workspace_group_ids
      required:
        - id
        - organization_id
        - name
        - description
        - category
        - created_at
        - archived_at
        - type
        - context
        - is_ai_enhanced
        - enabled
        - enabled_configuration
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````