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

# List Events



## OpenAPI

````yaml /api-reference/openapi.json get /v1/workspaces/{workspace}/streams/{stream_id}/events
openapi: 3.1.0
info:
  description: >-
    Modular and extensible framework for building AI agents. This API requires
    JWT Bearer token authentication for most endpoints. Include your JWT token
    in the Authorization header. Public endpoints include /, /health, /docs,
    /redoc, and /openapi.json.
  title: AgentArea API
  version: 0.1.0
servers: []
security:
  - bearer: []
paths:
  /v1/workspaces/{workspace}/streams/{stream_id}/events:
    get:
      tags:
        - v1
        - protected
        - streams
      summary: List Events
      operationId: list_events_v1_streams__stream_id__events_get
      parameters:
        - in: path
          name: stream_id
          required: true
          schema:
            format: uuid
            title: Stream Id
            type: string
        - description: Slug of the workspace the request acts in
          in: path
          name: workspace
          required: true
          schema:
            description: Slug of the workspace the request acts in
            maxLength: 120
            pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
            title: Workspace
            type: string
        - description: Oldest first, after this sequence.
          in: query
          name: after
          required: false
          schema:
            anyOf:
              - minimum: 0
                type: integer
              - type: 'null'
            description: Oldest first, after this sequence.
            title: After
        - description: Newest first, before this sequence.
          in: query
          name: before
          required: false
          schema:
            anyOf:
              - minimum: 1
                type: integer
              - type: 'null'
            description: Newest first, before this sequence.
            title: Before
        - in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 200
            minimum: 1
            title: Limit
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StreamEventPage'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    StreamEventPage:
      properties:
        events:
          items:
            $ref: '#/components/schemas/StreamEventResponse'
          title: Events
          type: array
        next_after:
          anyOf:
            - type: integer
            - type: 'null'
          description: 'With ?after=: pass as ?after= for the next page; null at the end.'
          title: Next After
        next_before:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Without ?after=: pass as ?before= for older events; null at the
            start.
          title: Next Before
      required:
        - events
      title: StreamEventPage
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    StreamEventResponse:
      properties:
        causation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Causation Id
        correlation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Correlation Id
        data:
          additionalProperties: true
          title: Data
          type: object
        depth:
          title: Depth
          type: integer
        event_id:
          format: uuid
          title: Event Id
          type: string
        event_key:
          title: Event Key
          type: string
        kind:
          title: Kind
          type: string
        occurred_at:
          format: date-time
          title: Occurred At
          type: string
        outcomes:
          description: >-
            One per subscription that took the event; empty means nobody
            listened.
          items:
            $ref: '#/components/schemas/OutcomeResponse'
          title: Outcomes
          type: array
        received_at:
          format: date-time
          title: Received At
          type: string
        sequence:
          title: Sequence
          type: integer
        source:
          title: Source
          type: string
        subject:
          anyOf:
            - type: string
            - type: 'null'
          title: Subject
      required:
        - sequence
        - event_id
        - event_key
        - kind
        - source
        - subject
        - occurred_at
        - received_at
        - correlation_id
        - causation_id
        - depth
        - data
        - outcomes
      title: StreamEventResponse
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    OutcomeResponse:
      properties:
        created_at:
          format: date-time
          title: Created At
          type: string
        derived_sequences:
          items:
            type: integer
          title: Derived Sequences
          type: array
        event_sequence:
          title: Event Sequence
          type: integer
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
        score:
          anyOf:
            - type: number
            - type: 'null'
          title: Score
        subscription_id:
          format: uuid
          title: Subscription Id
          type: string
        subscription_kind:
          title: Subscription Kind
          type: string
        task_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Task Id
        trigger_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Trigger Id
        verdict:
          description: reacted, skipped or error
          title: Verdict
          type: string
      required:
        - subscription_id
        - subscription_kind
        - trigger_id
        - event_sequence
        - verdict
        - reason
        - score
        - task_id
        - derived_sequences
        - created_at
      title: OutcomeResponse
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: JWT Bearer token for authentication
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.