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

# Thread-scoped agent event stream

> Server-side validated, correlation-filtered event stream for all running
agents in the thread. Validates participant membership, resolves active
agents, proxies their event streams, and filters to events whose
correlation_id matches a message_id in this thread. Returns SSE when
follow=true, JSON array otherwise.




## OpenAPI

````yaml /ai-app/openapi.yaml get /chat/threads/{id}/events
openapi: 3.0.3
info:
  title: Hill90 API
  description: Hill90 platform API — agent management and lifecycle operations.
  version: 0.1.0
servers:
  - url: /
    description: Relative (behind Traefik reverse proxy)
security: []
paths:
  /chat/threads/{id}/events:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
    get:
      summary: Thread-scoped agent event stream
      description: |
        Server-side validated, correlation-filtered event stream for all running
        agents in the thread. Validates participant membership, resolves active
        agents, proxies their event streams, and filters to events whose
        correlation_id matches a message_id in this thread. Returns SSE when
        follow=true, JSON array otherwise.
      parameters:
        - name: follow
          in: query
          schema:
            type: string
            enum:
              - 'true'
          description: Enable SSE streaming mode
        - name: tail
          in: query
          schema:
            type: integer
            default: 20
          description: Number of historical events to include
      responses:
        '200':
          description: Event stream (SSE) or event array (JSON)
        '404':
          description: Thread not found or not a participant
        '409':
          description: No running agents in thread
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````