---
title: "POST /entities/query/summarize"
method: POST
path: "/entities/query/summarize"
tags: ["Graph", "Entity"]
---

# POST /entities/query/summarize

`POST /entities/query/summarize`

## Headers

- `X-Authenticated-User-Actor-Id` string, uuid, required

## Request body

- SummarizeEntitiesParams
  - `filter` union, required
    - object
      - `all` Filter[], required
    - object
      - `any` Filter[], required
    - object
      - `not` Filter, required — recursive
    - object
      - `equal` FilterExpression[], required
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `notEqual` FilterExpression[], required
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `exists` PathExpression, required
        - `path` union[], required
          - union
            - 'baseUrl' | 'version' | 'versionedUrl' | 'webId' | 'title' | 'description' | 'type' | 'inheritsFrom' | 'children' | 'editionProvenance' | 'embedding' — A single token in a [`DataTypeQueryPath`].
            - 'baseUrl' | 'version' | 'versionedUrl' | 'webId' | 'title' | 'description' | 'editionProvenance' | 'dataTypes' | 'propertyTypes' | 'embedding' — A single token in a [`DataTypeQueryPath`].
            - 'baseUrl' | 'version' | 'versionedUrl' | 'webId' | 'title' | 'description' | 'properties' | 'required' | 'labelProperty' | 'icon' | 'editionProvenance' | 'links' | 'linkDestinations' | 'inheritsFrom' | 'children' | 'embedding' — A single token in a [`EntityTypeQueryPath`].
            - 'uuid' | 'editionId' | 'draftId' | 'archived' | 'webId' | 'type' | 'properties' | 'label' | 'createdById' | 'editionCreatedById' | 'createdAtTransactionTime' | 'createdAtDecisionTime' | 'provenance' | 'editionProvenance' | 'embedding' | 'incomingLinks' | 'outgoingLinks' | 'leftEntity' | 'rightEntity' — A single token in an [`EntityQueryPath`].
            - '*'
            - 'convert'
            - string
            - number
    - object
      - `greater` FilterExpression[]
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `greaterOrEqual` FilterExpression[]
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `less` FilterExpression[]
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `lessOrEqual` FilterExpression[]
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `startsWith` FilterExpression[], required
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `endsWith` FilterExpression[], required
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
    - object
      - `containsSegment` FilterExpression[], required
        - union
          - PathExpression
            - `path` union[], required
              - …
          - ParameterExpression
            - `convert` object
              - …
            - `parameter` unknown, required
  - `includeCount` boolean
  - `includeCreatedByIds` boolean
  - `includeDrafts` boolean, required
  - `includeEditionCreatedByIds` boolean
  - `includeTypeIds` boolean
  - `includeTypeTitles` boolean
  - `includeWebIds` boolean
  - `temporalAxes` union, required — Defines the two possible combinations of pinned/variable temporal axes that are used in queries that return [`Subgraph`]s. The [`VariableTemporalAxisUnresolved`] is optionally bounded, in the absence of provided bounds an inclusive bound at the timestamp at point of resolving is assumed. [`Subgraph`]: crate::subgraph::Subgraph
    - object
      - `pinned` object, required
        - `axis` 'transactionTime', required — Time axis for the transaction time. This is used as the generic argument to time-related structs and can be used as tag value.
        - `timestamp` string, date-time, nullable, required
      - `variable` object, required
        - `axis` 'decisionTime', required — Time axis for the decision time. This is used as the generic argument to time-related structs and can be used as tag value.
        - `interval` UnresolvedRightBoundedTemporalInterval, required
          - `end` union, required
            - object
              - …
            - object
              - …
          - `start` union, required
            - object
              - …
            - object
              - …
            - object
              - …
    - object
      - `pinned` object, required
        - `axis` 'decisionTime', required — Time axis for the decision time. This is used as the generic argument to time-related structs and can be used as tag value.
        - `timestamp` string, date-time, nullable, required
      - `variable` object, required
        - `axis` 'transactionTime', required — Time axis for the transaction time. This is used as the generic argument to time-related structs and can be used as tag value.
        - `interval` UnresolvedRightBoundedTemporalInterval, required
          - `end` union, required
            - object
              - …
            - object
              - …
          - `start` union, required
            - object
              - …
            - object
              - …
            - object
              - …

## Response `200`

- SummarizeEntitiesResponse
  - `count` integer
  - `createdByIds` object
  - `editionCreatedByIds` object
  - `typeIds` object
  - `typeTitles` object
  - `webIds` object

## Other responses

- `422` — Provided query is invalid
- `500` — Store error occurred

## Changes

- **2026-07-10** `0f1f205334eb` — 40 info
  - added the new `createdAtDecisionTime` enum value to the request property `filter/oneOf[subschema #10: LessOrEqualFilter]/lessOrEqual/items/oneOf[subschema #1: PathExpression]/path/items/oneOf[#/components/schemas/EntityQueryToken]/`
  - added the new `createdAtDecisionTime` enum value to the request property `filter/oneOf[subschema #11: StartsWithFilter]/startsWith/items/oneOf[subschema #1: PathExpression]/path/items/oneOf[#/components/schemas/EntityQueryToken]/`
  - added the new `createdAtDecisionTime` enum value to the request property `filter/oneOf[subschema #12: EndsWithFilter]/endsWith/items/oneOf[subschema #1: PathExpression]/path/items/oneOf[#/components/schemas/EntityQueryToken]/`
  - added the new `createdAtDecisionTime` enum value to the request property `filter/oneOf[subschema #13: ContainsSegmentFilter]/containsSegment/items/oneOf[subschema #1: PathExpression]/path/items/oneOf[#/components/schemas/EntityQueryToken]/`
  - …36 more
- **2026-06-29** `88cca4a72bed` — 1 breaking
  - removed `subschema #11: CosineDistanceFilter` from the `filter` request property `oneOf` list
- **2026-06-25** `d94249d1f3aa` — 1 info
  - endpoint added
- **2025-04-24** `ccac01e6aad0` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hashintel/apis/graph/changes/entities/query/summarize/post.md)

---

[API](https://skmtc.dev/hashintel/apis/graph.md) · [All operations](https://skmtc.dev/hashintel/apis/graph/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hashintel/graph/revisions/ba95e69ddba8/schema)