> ## Documentation Index > Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt > Use this file to discover all available pages before exploring further. # Visualize Live Events > Return search/improve events newer than a cursor, for the Memory tab's live timeline. Meant to be polled instead of re-fetching the whole `GET /visualize/json` payload just to refresh the timeline: pass the previous response's `cursor` back as `since` and only new events come back. The filter is strict, so nothing is ever delivered twice. ## Query Parameters - **dataset_id** (UUID): authorization only, see above - **since** (datetime, optional): cursor from a previous call ## Response `{"events": [...], "cursor": }` ## Error Codes - **403 Forbidden**: Caller lacks read permission on the dataset (or it does not exist) - **409 Conflict**: Payload could not be built (generic message; full detail is server-logged, not returned, to avoid leaking internals) ## Notes - User must have read permissions on the dataset ## OpenAPI ````yaml /cognee_openapi_spec.json get /api/v1/visualize/live-events openapi: 3.1.0 info: title: Cognee API description: Cognee API with Bearer token and Cookie auth version: 1.0.0 servers: - url: https://api.cognee.ai description: Production server (full functionality) - url: http://localhost:8000 description: Local development server (requires local setup) security: - BearerAuth: [] - ApiKeyAuth: [] tags: - name: activity description: '' - name: add description: Data ingestion endpoints for adding text, files, and structured data. - name: agent connections description: '' - name: agent management description: '' - name: auth description: >- Authentication endpoints for user registration, login, and token management. - name: checks description: '' - name: cognify description: >- Knowledge processing endpoints to transform raw data into knowledge graphs. - name: configuration description: '' - name: datasets description: Dataset management endpoints for listing, creating, and deleting datasets. - name: delete description: Data deletion endpoints (deprecated — use datasets endpoints instead). - name: forget description: '' - name: health description: '' - name: improve description: '' - name: integrations description: '' - name: llm description: '' - name: memify description: '' - name: ontologies description: '' - name: permissions description: Permission management for multi-user access control. - name: recall description: '' - name: remember description: '' - name: responses description: Response generation endpoints using the knowledge graph. - name: schema description: '' - name: search description: Search endpoints for querying the knowledge graph. - name: sessions description: '' - name: settings description: Configuration endpoints for managing Cognee settings. - name: skills description: '' - name: slack description: '' - name: sync description: '' - name: update description: '' - name: users description: User management endpoints. - name: visualize description: Graph visualization endpoints. paths: /api/v1/visualize/live-events: get: tags: - visualize summary: Visualize Live Events description: >- Return search/improve events newer than a cursor, for the Memory tab's live timeline. Meant to be polled instead of re-fetching the whole `GET /visualize/json` payload just to refresh the timeline: pass the previous response's `cursor` back as `since` and only new events come back. The filter is strict, so nothing is ever delivered twice. ## Query Parameters - **dataset_id** (UUID): authorization only, see above - **since** (datetime, optional): cursor from a previous call ## Response `{"events": [...], "cursor": }` ## Error Codes - **403 Forbidden**: Caller lacks read permission on the dataset (or it does not exist) - **409 Conflict**: Payload could not be built (generic message; full detail is server-logged, not returned, to avoid leaking internals) ## Notes - User must have read permissions on the dataset operationId: visualize_live_events_api_v1_visualize_live_events_get parameters: - name: dataset_id in: query required: true schema: type: string format: uuid description: >- UUID of the dataset this poll is for. Gates who may call this endpoint (same read-permission check as every other visualize route) — the events themselves are the caller's own, not filtered to this dataset's graph. examples: - '' title: Dataset Id description: >- UUID of the dataset this poll is for. Gates who may call this endpoint (same read-permission check as every other visualize route) — the events themselves are the caller's own, not filtered to this dataset's graph. - name: since in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: >- Cursor from a previous call's response. Omit on the first call to get every available event. title: Since description: >- Cursor from a previous call's response. Omit on the first call to get every available event. responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ApiKeyAuth: type: apiKey in: header name: X-Api-Key ````