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

# Obtenir microservei per identificador

> Retorna un microservei visible per a l'organització objectiu (designer o marketplace), amb estat d'habilitació i configuració habilitada quan existeixi.



## OpenAPI

````yaml /ca/api-reference/openapi.ca-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 pública REST per al portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/microservices/{microservice_id}:
    get:
      tags:
        - Microserveis
      summary: Obtenir microservei per identificador
      description: >-
        Retorna un microservei visible per a l'organització objectiu (designer o
        marketplace), amb estat d'habilitació i configuració habilitada quan
        existeixi.
      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 l'organització sobre la qual es consulta el
            microservei.
          example: 507f1f77bcf86cd799439011
        - name: microservice_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador del microservei a recuperar.
          example: 65f0d9f2b3c4d5e6f7080911
        - name: Accept-Language
          in: header
          required: false
          schema:
            type: string
            default: es-ES
            maxLength: 10
          description: Idioma per resoldre camps multilingües a un únic valor per camp.
          example: es-ES
      responses:
        '200':
          description: Microservei recuperat correctament.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMicroserviceByIdResponseV1'
              examples:
                microservicio_habilitado:
                  summary: Microservei trobat amb configuració activada
                  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: Microservei trobat sense configuració activada
                  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: Paràmetres de solicitud invàlids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                id_invalido:
                  summary: Identificador de microservei invàlid
                  value:
                    error:
                      message: Parametro microservice_id invalido
                      code: bad_request
        '401':
          description: No autoritzat o sense accés a l'organització.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                organization_not_authorized:
                  summary: Accés a organització no autoritzat
                  value:
                    error:
                      message: No autorizado
                      code: unauthorized
        '404':
          description: Microservei no trobat dins l'abast autoritzat de l'organització.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                microservice_not_found:
                  summary: Microservei no trobat
                  value:
                    error:
                      message: No encontrado
                      code: not_found
        '500':
          description: Error intern del servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unexpected_error:
                  summary: Error inesperat
                  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 microservei.
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador de l'organització associada al microservei.
        name:
          type: string
          description: Nom del microservei resolt en l'idioma sol·licitat.
        description:
          type: string
          description: Descripció del microservei resolta en l'idioma sol·licitat.
        category:
          type: string
          description: Categoria del microservei resolta en l'idioma sol·licitat.
        created_at:
          type: string
          format: date-time
          description: Data i hora de creació del microservei.
        archived_at:
          type: string
          format: date-time
          nullable: true
          description: Data i hora de l'arxiu, quan sigui aplicable.
        type:
          type: string
          enum:
            - standard
            - condition
          nullable: true
          description: Tipus funcional del microservei.
        context:
          type: string
          nullable: true
          description: Context de visibilitat del microservei.
        is_ai_enhanced:
          type: boolean
          nullable: true
          description: Indica si el microservei té capacitats de IA habilitades.
        enabled:
          type: boolean
          description: Indica si el microservei està habilitat per a l'organització.
        enabled_configuration:
          type: object
          nullable: true
          description: Configuració habilitada del microservei per a l'organització.
          properties:
            enabled_at:
              type: string
              format: date-time
              nullable: true
              description: Data i hora en què es va habilitar la configuració.
            efficiency:
              type: number
              description: Valor d'eficiència de la configuració habilitada.
            workspace_group_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Mode d'execució per grups de workspace.
            individual_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Mode d'execució individual.
            end_user_execution_workspace_group_ids:
              type: array
              items:
                type: string
                pattern: ^[0-9a-f]{24}$
                minLength: 24
                maxLength: 24
              description: >-
                Identificadors de grups de workspace habilitats per a execució
                d'usuari 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

````