---
title: "List files in Definite Drive"
method: GET
path: "/v3/teams/{team_id}/drive/files"
tags: ["v3", "Drive"]
---

# List files in Definite Drive

`GET /v3/teams/{team_id}/drive/files`

List all files in Definite Drive for the team.

    Optionally filter by prefix to list files in a specific directory.
    Files are returned with metadata including size, creation time, and content type.

## Path parameters

- `team_id` string, required

## Query parameters

- `prefix` string, nullable

## Response `200`

List of files

- DriveListResponse — Response containing list of files in Definite Drive.
  - `files` DriveFile[], required — List of files
    - `name` string, required — Filename only (e.g., 'report.csv')
    - `path` string, required — Full path within drive (e.g., 'data/reports/report.csv')
    - `size` integer, required — File size in bytes
    - `created_at` string, date-time, required — When the file was created
    - `updated_at` string, date-time, required — When the file was last modified
    - `content_type` string, nullable — MIME type of the file
  - `total_count` integer, required — Total number of files

## Other responses

- `422` — Validation Error
- `500` — Failed to list files

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)