---
title: "Stream Sentiment"
method: POST
path: "/v1/reports/sentiment/stream"
tags: ["Reports", "Reports"]
---

# Stream Sentiment

`POST /v1/reports/sentiment/stream`

## Request body

- StreamSentimentQuery
  - `date_interval` 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year' | 'relative_week' — Date interval for the report. (only used with date dimension)
  - `dimensions` string[] — Dimensions to group the report by.
  - `metrics` string[], required
  - `order_by` object — Custom ordering of the report results. The order is a record of key-value pairs where: - key is the field to order by, which can be a metric or dimension - value is the direction of the order, either 'asc' for ascending or 'desc' for descending. When not specified, the default order is the first metric in the query descending.
  - `pagination` Pagination — Offset-based pagination parameters.
    - `limit` integer — Maximum number of results to return. Default is 10,000, maximum is 50,000.
    - `offset` integer — Offset for the results. Used for pagination.
  - `category_id` string, uuid, required
  - `start_date` string, date-time, required — Start date for the report. Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or full ISO timestamp.
  - `end_date` string, date-time, required — End date for the report. Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or full ISO timestamp.
  - `filters` union[] — List of filters to apply to the sentiment report.
    - union
      - AssetIdFilter
        - `field` 'asset_id', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - ProfoundAnswerEngineInsightsFiltersAssetNameFilter — Filter by asset name
        - `field` 'asset_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - ThemeFilter — Filter by theme
        - `field` 'theme', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - RegionIdFilter — Filter by region UUID.
        - `field` union, required
          - 'region_id'
          - 'region'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - RegionNameFilter — Filter by region name.
        - `field` 'region_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - TopicIdFilter — Filter by topic UUID.
        - `field` union, required
          - 'topic_id'
          - 'topic'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - TopicNameFilter — Filter by topic name
        - `field` 'topic_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - ModelIdFilter — Filter by AI model/platform UUID.
        - `field` union, required
          - 'model_id'
          - 'model'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - TagIdFilter — Filter by tag (prompt group) UUID.
        - `field` union, required
          - 'tag_id'
          - 'tag'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - TagNameFilter — Filter by tag name.
        - `field` 'tag_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - PromptFilter — Filter by prompt text
        - `field` 'prompt', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - PersonaIdFilter — Filter by persona UUID.
        - `field` 'persona_id', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]

## Response `200`

Server-sent events stream. Emits a `summary` event first, then one `row` event per streamed row.

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-17** `56d428ca479f` — 1 breaking, 2 info
  - removed `#/components/schemas/AssetNameFilter` from the `filters/items/` request property `oneOf` list
  - mapped value for discriminator key `asset_name` changed from `#/components/schemas/AssetNameFilter` to `#/components/schemas/profound_answer_engine_insights__filters__AssetNameFilter` for `filters/items/` request property
  - added `#/components/schemas/profound_answer_engine_insights__filters__AssetNameFilter` to the `filters/items/` request property `oneOf` list
- **2026-05-01** `c55c2a1636c3` — 1 info
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-04-29** `095e0773f3a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cooper-square-technologies/apis/external-api/changes/v1/reports/sentiment/stream/post.md)

---

[API](https://skmtc.dev/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.dev/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/revisions/ab03b3c80494/schema)