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

**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 files and don't see them in the results, retry after a brief delay.

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

`POST /v1/datasets/{dataset_id}/files/query`