---
title: "List Files"
method: GET
path: "/api/v1alpha1/assistant/{assistant_kind}/files"
tags: ["v1alpha1"]
---

# List Files

`GET /api/v1alpha1/assistant/{assistant_kind}/files`

The calling member's files for this kind, newest first — the "all files" view.

Both pending and active files are returned with their state, so a client
rendering "all files" can show an in-flight upload rather than a gap. This
does not mint signed GET URLs — clients resolve individual files via
``GET /files/{file_id}/content`` when rendering, same as any other ref.

## Query parameters

- `created_before` string, date-time, nullable — Exclusive cursor: only files created before this timestamp. Pass the last item's createdAt to fetch the next (older) page.
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- FileListResponse
  - `files` FileResource[], required
    - `fileId` string, required
    - `ref` string, required
    - `state` string, required
    - `contentType` string, required
    - `sizeBytes` integer, nullable
    - `createdAt` string, date-time, nullable
    - `caption` string, nullable
  - `hasMore` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/trademeai/apis/trade-me-ai-platform.md) · [All operations](https://skmtc.net/trademeai/apis/trade-me-ai-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trademeai/trade-me-ai-platform/revisions/02634860dec7/schema)