> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galileo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Signals

> List top-level Signals for one log stream or experiment run.

Results are ordered by internal priority and last seen time. Open Signals whose notifications
are not muted are returned by default. A cursor may be reused only with the same filters.



## OpenAPI

````yaml https://api.galileo.ai/public/v2/openapi.json get /v2/projects/{project_id}/runs/{run_id}/signals
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://api.galileo.ai
    description: Galileo Public APIs - galileo-v2
security: []
paths:
  /v2/projects/{project_id}/runs/{run_id}/signals:
    get:
      tags:
        - signals-v2
      summary: List Signals
      description: >-
        List top-level Signals for one log stream or experiment run.


        Results are ordered by internal priority and last seen time. Open
        Signals whose notifications

        are not muted are returned by default. A cursor may be reused only with
        the same filters.
      operationId: list_signals_v2_projects__project_id__runs__run_id__signals_get
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            format: uuid4
            title: Project Id
        - name: run_id
          in: path
          required: true
          schema:
            type: string
            format: uuid4
            title: Run Id
        - name: search
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 255
                minLength: 1
              - type: 'null'
            description: >-
              Case-insensitive title and problem search. An exact SIG-N value
              also matches the display key.
            title: Search
          description: >-
            Case-insensitive title and problem search. An exact SIG-N value also
            matches the display key.
        - name: labels
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              maxLength: 255
              minLength: 1
            maxItems: 20
            description: Match Signals containing any selected label.
            title: Labels
          description: Match Signals containing any selected label.
        - name: severities
          in: query
          required: false
          schema:
            type: array
            items:
              $ref: '#/components/schemas/SignalSeverityLevel'
            maxItems: 3
            description: Severity levels to include.
            title: Severities
          description: Severity levels to include.
        - name: statuses
          in: query
          required: false
          schema:
            type: array
            items:
              $ref: '#/components/schemas/SignalStatus'
            maxItems: 2
            description: User-marked states to include. Defaults to open Signals.
            title: Statuses
          description: User-marked states to include. Defaults to open Signals.
        - name: notification_state
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/SignalNotificationStateFilter'
            description: >-
              Notification state to include. Defaults to Signals whose
              notifications are not muted.
            default: UNMUTED
          description: >-
            Notification state to include. Defaults to Signals whose
            notifications are not muted.
        - name: last_seen_after
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Include Signals last seen at or after this timestamp.
            title: Last Seen After
          description: Include Signals last seen at or after this timestamp.
        - name: last_seen_before
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Include Signals last seen before this timestamp.
            title: Last Seen Before
          description: Include Signals last seen before this timestamp.
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 2048
              - type: 'null'
            description: Cursor returned by the previous page with the same filters.
            title: Cursor
          description: Cursor returned by the previous page with the same filters.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Maximum Signals returned in one page.
            default: 50
            title: Limit
          description: Maximum Signals returned in one page.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignalListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - ClassicAPIKeyHeader: []
        - OAuth2PasswordBearer: []
        - HTTPBasic: []
components:
  schemas:
    SignalSeverityLevel:
      type: string
      enum:
        - LOW
        - MEDIUM
        - HIGH
      title: SignalSeverityLevel
      description: Severity level shown to users and used for notification selection.
    SignalStatus:
      type: string
      enum:
        - OPEN
        - RESOLVED
      title: SignalStatus
      description: Signal state selected by a user.
    SignalNotificationStateFilter:
      type: string
      enum:
        - UNMUTED
        - MUTED
        - ALL
      title: SignalNotificationStateFilter
      description: Whether a list includes Signals with muted notifications.
    SignalListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/SignalSummary'
          type: array
          title: Data
        meta:
          $ref: '#/components/schemas/SignalListMeta'
        facets:
          $ref: '#/components/schemas/SignalFacets'
      additionalProperties: false
      type: object
      required:
        - data
        - meta
        - facets
      title: SignalListResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SignalSummary:
      properties:
        id:
          type: string
          format: uuid4
          title: Id
        display_key:
          type: string
          title: Display Key
        title:
          type: string
          title: Title
        description:
          type: string
          title: Description
        labels:
          items:
            type: string
          type: array
          title: Labels
        severity_level:
          $ref: '#/components/schemas/SignalSeverityLevel'
        status:
          $ref: '#/components/schemas/SignalStatus'
          description: Whether the user has marked the Signal open or resolved.
        notifications_muted:
          type: boolean
          title: Notifications Muted
          description: Whether notifications are muted for this Signal.
        affected_session_count:
          type: integer
          minimum: 0
          title: Affected Session Count
          description: Affected sessions reported by the scan that last saw the Signal.
        remediation_summary:
          $ref: '#/components/schemas/SignalRemediationSummary'
        merged_signal_count:
          type: integer
          minimum: 0
          title: Merged Signal Count
          description: Signals currently merged into this Signal.
        last_seen_at:
          type: string
          format: date-time
          title: Last Seen At
          description: Time of the latest occurrence found for this Signal.
      additionalProperties: false
      type: object
      required:
        - id
        - display_key
        - title
        - description
        - labels
        - severity_level
        - status
        - notifications_muted
        - affected_session_count
        - remediation_summary
        - merged_signal_count
        - last_seen_at
      title: SignalSummary
      description: Compact Signal representation used by the list page.
    SignalListMeta:
      properties:
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: Cursor for the next page, or null on the last page.
        total:
          type: integer
          minimum: 0
          title: Total
          description: Signals matching all current filters before pagination.
      additionalProperties: false
      type: object
      required:
        - next_cursor
        - total
      title: SignalListMeta
    SignalFacets:
      properties:
        labels:
          items:
            $ref: '#/components/schemas/SignalLabelFacet'
          type: array
          title: Labels
        open_count:
          type: integer
          minimum: 0
          title: Open Count
        resolved_count:
          type: integer
          minimum: 0
          title: Resolved Count
        muted_count:
          type: integer
          minimum: 0
          title: Muted Count
      additionalProperties: false
      type: object
      required:
        - labels
        - open_count
        - resolved_count
        - muted_count
      title: SignalFacets
      description: |-
        Filter options and counts computed before pagination.

        A facet ignores its own filter while applying the other active filters.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    SignalRemediationSummary:
      properties:
        primary_recommendation:
          anyOf:
            - $ref: '#/components/schemas/SignalRecommendationSummary'
            - type: 'null'
          description: Highest-ranked remediation for the Signal.
        latest_action:
          anyOf:
            - $ref: '#/components/schemas/SignalRecommendationSummary'
            - type: 'null'
          description: Most recently updated remediation that has moved beyond proposal.
        recommendation_count:
          type: integer
          minimum: 0
          title: Recommendation Count
          description: Number of remediations generated for the Signal.
        completed_action_count:
          type: integer
          minimum: 0
          title: Completed Action Count
          description: Number of remediations that were applied or validated.
      additionalProperties: false
      type: object
      required:
        - primary_recommendation
        - latest_action
        - recommendation_count
        - completed_action_count
      title: SignalRemediationSummary
      description: Remediation counts and actions shown on one Signal row.
    SignalLabelFacet:
      properties:
        label:
          type: string
          title: Label
        count:
          type: integer
          minimum: 0
          title: Count
      additionalProperties: false
      type: object
      required:
        - label
        - count
      title: SignalLabelFacet
    SignalRecommendationSummary:
      properties:
        id:
          type: string
          format: uuid4
          title: Id
        type:
          type: string
          title: Type
          description: Remediation type, such as evaluator.create or agent-control.create.
        title:
          type: string
          title: Title
        state:
          $ref: '#/components/schemas/SignalRemediationState'
          description: Current state of the proposed or applied remediation.
      additionalProperties: false
      type: object
      required:
        - id
        - type
        - title
        - state
      title: SignalRecommendationSummary
      description: List-page representation of one remediation.
    SignalRemediationState:
      type: string
      enum:
        - PROPOSED
        - IN_PROGRESS
        - APPLIED
        - VALIDATED
        - DISMISSED
        - FAILED
      title: SignalRemediationState
      description: Current state of a proposed remediation.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: Splunk-AO-API-Key
    ClassicAPIKeyHeader:
      type: apiKey
      in: header
      name: Galileo-API-Key
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: https://api.galileo.ai/login
    HTTPBasic:
      type: http
      scheme: basic

````