---
title: "List scenes — what happened, together, when"
method: GET
path: "/v1/scenes"
tags: ["Scenes"]
---

# List scenes — what happened, together, when

`GET /v1/scenes`

## Request

- Base URL: `https://brain.inite.ai`
- URL: `https://brain.inite.ai/v1/scenes`
- Auth: HTTP bearer

Scenes of the current segmenter world (memory_episode: coherent multi-turn groupings the composer derives from raw turns), newest first, with their member episodes, knowledge-graph backlinks, enrichment-owned state deltas (the beliefs are promoted from these) and per-dimension memory value. Filter by conversationId, entityId, since/until (overlap) and user scope. A user-bound token is pinned to its own user (userId mismatch is 403) and sees its own scenes plus tenant-global ones whose member set contains it; an M2M key scopes to any user with userId, and without one lists tenant-global scenes only (gists quote verbatim turns — the episodes contract). Scenes carrying PII need brain:read_pii. Page capped at 100 (default 25). `world` names the version served (empty until a world has been composed). On by default; SCENES_API_ENABLED=0 makes it a 404. Source: src/scenes/scenes.controller.ts.

Required scope: `brain:read`.

## Query parameters

- `conversationId` string
- `entityId` string
- `userId` string
- `since` string
- `until` string
- `limit` integer

## Response `200`

The visible scenes.

- ScenesListResponse
  - `found` number, required
  - `scenes` SceneReadResponse[], required
    - `confidence` number, required
    - `conversationIds` string[], required
    - `enriched` boolean, required
    - `enrichedGist` string
    - `entityIds` string[], required
    - `episodeIds` string[], required
    - `factIds` string[], required
    - `gist` string, required
    - `memoryValue` object
      - `contradiction` number
      - `estimatedUtility` number
      - `explicitness` number
      - `identity` number
      - `novelty` number
      - `scorerVersion` string
      - `stateChange` number
    - `occurredFrom` string, required
    - `occurredTo` string, required
    - `recordedAt` string, required
    - `sceneId` string, required
    - `sceneLabel` string, required
    - `segmenterVersion` string, required
    - `stateDeltas` object[], required
      - `field` string, required
      - `from` string
      - `subject` string, required
      - `to` string
    - `unexpectedDetails` string[], required
    - `userId` string
    - `userIds` string[], required
  - `world` string, required

## Other responses

- `400`: Validation failed.
- `401`: Missing or unknown bearer key.
- `403`: The key lacks the required scope.
- `404`: No such resource in this tenant.

---

[API](https://skmtc.dev/inite/apis/inite-brain-platform-api.md) · [All operations](https://skmtc.dev/inite/apis/inite-brain-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inite/apis/inite-brain-platform-api/revisions/c7c3eb5e304b?raw)