get:
  summary: List agents
  tags:
    - Agents
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            $ref: ../components/schemas/get_agents_response.yaml
    '400':
      $ref: ../components/responses/error.yaml
  operationId: get-agents
  parameters:
    - $ref: ../components/parameters/page_size.yaml
    - $ref: ../components/parameters/page_index.yaml
    - $ref: ../components/parameters/kuery.yaml
    - $ref: ../components/parameters/show_inactive.yaml
    - $ref: ../components/parameters/show_upgradeable.yaml
    - $ref: ../components/parameters/sort_field.yaml
    - $ref: ../components/parameters/sort_order.yaml
    - $ref: ../components/parameters/with_metrics.yaml
    - name: getStatusSummary
      in: query
      required: false
      schema:
        type: boolean
  security:
    - basicAuth: []
post:
  summary: List agents by action ids
  tags:
    - Agents
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            $ref: ../components/schemas/agent_get_by_actions.yaml
    '400':
      $ref: ../components/responses/error.yaml
  operationId: get-agents-by-actions
  parameters:
    - $ref: ../components/headers/kbn_xsrf.yaml
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          properties:
            actionIds:
              type: array
              items:
                  type: string
          required:
            - policy_id