> ## 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 Signal Affected Sessions

> List affected sessions and stored evidence for one Signal and its merged Signals.



## OpenAPI

````yaml https://api.galileo.ai/public/v2/openapi.json get /v2/projects/{project_id}/runs/{run_id}/signals/{signal_id}/affected-sessions
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/{signal_id}/affected-sessions:
    get:
      tags:
        - signals-v2
      summary: List Signal Affected Sessions
      description: >-
        List affected sessions and stored evidence for one Signal and its merged
        Signals.
      operationId: >-
        list_signal_affected_sessions_v2_projects__project_id__runs__run_id__signals__signal_id__affected_sessions_get
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            format: uuid4
            title: Project Id
        - name: signal_id
          in: path
          required: true
          schema:
            type: string
            format: uuid4
            title: Signal Id
        - name: run_id
          in: path
          required: true
          schema:
            type: string
            format: uuid4
            title: Run Id
        - name: last_seen_after
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: Last Seen After
        - name: last_seen_before
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: Last Seen Before
        - name: scan_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid4
              - type: 'null'
            title: Scan Id
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 2048
              - type: 'null'
            title: Cursor
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 25
            title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignalAffectedSessionListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - ClassicAPIKeyHeader: []
        - OAuth2PasswordBearer: []
        - HTTPBasic: []
components:
  schemas:
    SignalAffectedSessionListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/SignalAffectedSession'
          type: array
          title: Data
        meta:
          $ref: '#/components/schemas/SignalAffectedSessionListMeta'
      additionalProperties: false
      type: object
      required:
        - data
        - meta
      title: SignalAffectedSessionListResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SignalAffectedSession:
      properties:
        session_id:
          type: string
          format: uuid4
          title: Session Id
        last_seen_at:
          type: string
          format: date-time
          title: Last Seen At
        last_seen_scan_id:
          type: string
          format: uuid4
          title: Last Seen Scan Id
        occurrence_count:
          type: integer
          minimum: 1
          title: Occurrence Count
        trace_count:
          type: integer
          minimum: 0
          title: Trace Count
        span_count:
          type: integer
          minimum: 0
          title: Span Count
        occurrences:
          items:
            $ref: '#/components/schemas/SignalOccurrence'
          type: array
          title: Occurrences
      additionalProperties: false
      type: object
      required:
        - session_id
        - last_seen_at
        - last_seen_scan_id
        - occurrence_count
        - trace_count
        - span_count
        - occurrences
      title: SignalAffectedSession
      description: Occurrences grouped under one affected session.
    SignalAffectedSessionListMeta:
      properties:
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
        total:
          type: integer
          minimum: 0
          title: Total
      additionalProperties: false
      type: object
      required:
        - next_cursor
        - total
      title: SignalAffectedSessionListMeta
    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
    SignalOccurrence:
      properties:
        id:
          type: string
          format: uuid4
          title: Id
        occurrence_ref:
          type: string
          title: Occurrence Ref
        origin_signal:
          $ref: '#/components/schemas/SignalReference'
        scan_id:
          type: string
          format: uuid4
          title: Scan Id
        session_id:
          type: string
          format: uuid4
          title: Session Id
        observed_at:
          type: string
          format: date-time
          title: Observed At
        problem_type_id:
          type: string
          title: Problem Type Id
        problem_nature:
          $ref: '#/components/schemas/SignalProblemNature'
        outcome:
          $ref: '#/components/schemas/SignalOccurrenceOutcome'
        component:
          $ref: '#/components/schemas/SignalComponent'
        description:
          type: string
          title: Description
        classification_rationale:
          type: string
          title: Classification Rationale
        evidence:
          items:
            $ref: '#/components/schemas/SignalEvidenceReference'
          type: array
          title: Evidence
      additionalProperties: false
      type: object
      required:
        - id
        - occurrence_ref
        - origin_signal
        - scan_id
        - session_id
        - observed_at
        - problem_type_id
        - problem_nature
        - outcome
        - component
        - description
        - classification_rationale
        - evidence
      title: SignalOccurrence
      description: One defect occurrence found in a completed session.
    SignalReference:
      properties:
        id:
          type: string
          format: uuid4
          title: Id
        display_key:
          type: string
          title: Display Key
        title:
          type: string
          title: Title
        last_seen_at:
          type: string
          format: date-time
          title: Last Seen At
      additionalProperties: false
      type: object
      required:
        - id
        - display_key
        - title
        - last_seen_at
      title: SignalReference
      description: Signal identity shown for a merge relationship.
    SignalProblemNature:
      type: string
      enum:
        - REALIZED_DEFECT
        - INEFFICIENCY
        - RISK_EXPOSURE
      title: SignalProblemNature
      description: Nature of one defect occurrence.
    SignalOccurrenceOutcome:
      type: string
      enum:
        - SUCCEEDED
        - PARTIALLY_SUCCEEDED
        - FAILED
        - UNKNOWN
      title: SignalOccurrenceOutcome
      description: Outcome of the session containing an occurrence.
    SignalComponent:
      properties:
        type:
          $ref: '#/components/schemas/StepType'
        name:
          type: string
          title: Name
      additionalProperties: false
      type: object
      required:
        - type
        - name
      title: SignalComponent
      description: Agent component associated with a Signal or occurrence.
    SignalEvidenceReference:
      properties:
        trace_id:
          type: string
          format: uuid4
          title: Trace Id
        span_id:
          type: string
          format: uuid4
          title: Span Id
        explanation:
          type: string
          title: Explanation
      additionalProperties: false
      type: object
      required:
        - trace_id
        - span_id
        - explanation
      title: SignalEvidenceReference
      description: Trace span cited as evidence for one occurrence.
    StepType:
      type: string
      enum:
        - http
        - llm
        - retriever
        - tool
        - workflow
        - agent
        - control
        - trace
        - session
      title: StepType
  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

````