---
search:
  tags:
    - Files
    - POST
seo:
  description: >-
    Get the count of files matching a query. Reference for the POST
    /v1/files/query/result-count endpoint in the Roboto REST API.
sidebar:
  label: Get file query result count
  badge: POST
title: Get file query result count
type: openapi-operation
---
Get the count of files matching a query.

**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.
The count may not immediately reflect very recent writes. If you've just created or
updated files and don't see them in the count, 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/result-count`