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

**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
 - requires_resource_owner_or_admin
 - Restricted tokens need the API scope `api.everything_else`

`POST /v1/files/query`