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

# List organization microservices

> Returns a paginated list of microservices visible to the target organization (own or delegated according to caller's permissions), enriched with its enablement status and associated configuration when present. Enablement resolution is strictly performed with the organization_id sent in the path.



## OpenAPI

````yaml /en/api-reference/openapi.en-v1.json get /v1/organizations/{organization_id}/microservices
openapi: 3.0.3
info:
  title: Public Portal API
  version: 1.0.0
  description: Public REST API for portal
servers:
  - url: https://api.staging.flxwvdexternal.com
    description: Staging API server.
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/microservices:
    get:
      tags:
        - Microservices
      summary: List organization microservices
      description: >-
        Returns a paginated list of microservices visible to the target
        organization (own or delegated according to caller's permissions),
        enriched with its enablement status and associated configuration when
        present. Enablement resolution is strictly performed with the
        organization_id sent in the path.
      operationId: get_microservices
      parameters:
        - name: organization id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: >-
            Identifier of the target organization querying the catalog;
            enablement is verified against this same identifier.
          example: 507f1f77bcf86cd799439011
        - name: Accept-Language
          in: header
          required: false
          schema:
            type: string
            default: es-ES
            maxLength: 10
          description: >-
            Language to resolve the multilingual fields of the response to a
            single value per field.
          example: es-ES
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number.
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            maximum: 100
            minimum: 1
          description: Number of items per page.
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: Response fields to be included, separated by commas.
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: JSON expression of filters on filterable resource fields.
          examples:
            simple:
              summary: Simple filter by name
              value: '{"field":"name","op":"contains","value":"backup"}'
            complex-and:
              summary: Combined filter with AND
              value: >-
                {"and":[{"field":"type","op":"eq","value":"standard"},{"field":"context","op":"eq","value":"organization"}]}
            complex-or-and:
              summary: Combined filter with OR and AND
              value: >-
                {"and":[{"or":[{"field":"category","op":"eq","value":"security"},{"field":"category","op":"eq","value":"automation"}]},{"field":"name","op":"contains","value":"agent"}]}
      responses:
        '200':
          description: Microservices successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMicroservicesResponseV1'
              examples:
                resultado_con_datos:
                  summary: List with results
                  value:
                    has_next: false
                    data:
                      - id: 65f0d9f2b3c4d5e6f7080911
                        organization_id: 507f1f77bcf86cd799439011
                        name: Antivirus Scan
                        description: Scheduled antivirus scan
                        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
                      - id: 65f0d9f2b3c4d5e6f7080912
                        organization_id: 507f1f77bcf86cd799439011
                        name: Patch Baseline
                        description: Pending patches control
                        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: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                filters_invalido:
                  summary: Invalid filters format
                  value:
                    error:
                      message: Invalid filters format
                      code: bad_request
                      details: The filters parameter must be a valid JSON string.
        '401':
          description: Not authorized or without access to the organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                organization_not_authorized:
                  summary: Access to organization not authorized
                  value:
                    error:
                      message: Unauthorized
                      code: unauthorized
        '404':
          description: >-
            The requested resource was not found within the organization's
            authorized scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                resource_not_found:
                  summary: Resource not found
                  value:
                    error:
                      message: Not Found
                      code: not_found
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unexpected_error:
                  summary: Unhandled error
                  value:
                    error:
                      message: Internal Server Error
                      code: internal_error
components:
  schemas:
    GetMicroservicesResponseV1:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indicates if there's a next page.
        data:
          type: array
          items:
            $ref: '#/components/schemas/MicroserviceItemV1'
      required:
        - has_next
        - 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: Microservice identifier.
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Organization identifier associated with the microservice.
        name:
          type: string
          description: Microservice name resolved in the requested language.
        description:
          type: string
          description: Microservice description resolved in the requested language.
        category:
          type: string
          description: Microservice category resolved in the requested language.
        created_at:
          type: string
          format: date-time
          description: Microservice creation date and time.
        archived_at:
          type: string
          format: date-time
          nullable: true
          description: Archived date and time, when applicable.
        type:
          type: string
          enum:
            - standard
            - condition
          nullable: true
          description: Functional type of microservice.
        context:
          type: string
          nullable: true
          description: Microservice visibility context.
        is_ai_enhanced:
          type: boolean
          nullable: true
          description: Indicates if AI capabilities are enhanced for the microservice.
        enabled:
          type: boolean
          description: Indicates if the microservice is enabled for the organization.
        enabled_configuration:
          type: object
          nullable: true
          description: Organization enabled microservice configuration.
          properties:
            enabled_at:
              type: string
              format: date-time
              nullable: true
              description: Date and time the configuration was enabled.
            efficiency:
              type: number
              description: Enabled configuration efficiency value.
            workspace_group_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Execution mode by workspace groups.
            individual_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Individual execution mode.
            end_user_execution_workspace_group_ids:
              type: array
              items:
                type: string
                pattern: ^[0-9a-f]{24}$
                minLength: 24
                maxLength: 24
              description: Identifiers of workspace groups enabled for end user execution.
          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

````