---
search:
  tags:
    - Datasets
    - POST
seo:
  description: >-
    Execute a query against datasets. Reference for the POST /v1/datasets/query
    endpoint in the Roboto REST API.
sidebar:
  label: Query datasets
  badge: POST
title: Query datasets
type: openapi-operation
---
Execute a query against datasets.

**Consistency:** Eventually Consistent (for API version >= 2026-03-13)

- Clients using API version < 2026-03-13: Strongly consistent reads
- Clients using API version >= 2026-03-13: Eventually consistent reads
- Override: Send X-Roboto-Connection-Consistency header to explicitly control behavior

This endpoint uses eventual consistency for improved performance and scalability.
Results may not immediately reflect very recent writes. If you've just created or
updated datasets and don't see them in the results, retry after a brief delay.

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

`POST /v1/datasets/query`