---
search:
  tags:
    - Viz
    - POST
seo:
  description: >-
    Specialized, viz-only query for the events relevant to a workspace.
    Reference for the POST /v1/viz/events endpoint in the Roboto REST API.
sidebar:
  label: Query workspace events
  badge: POST
title: Query workspace events
type: openapi-operation
---
Specialized, viz-only query for the events relevant to a workspace.

Takes the workspace's data sources (datasets and loose files) and returns every
event within their scope; see :py:class:`WorkspaceEventsRequest`. Like the rest of
the event read path, results are filtered to the events the caller can view.

### Access control
 - Restricted tokens need the API scope `api.everything_else`

`POST /v1/viz/events`