---
title: "Get Most Recent Files"
method: GET
path: "/asset/most_recent"
tags: ["accepts-api-key"]
---

# Get Most Recent Files

`GET /asset/most_recent`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/asset/most_recent`
- Auth: none declared

Return the most recently added file(s) the user has read access to.
Uses the user's own library unless group_id is set.
With group_id, uses what that group was given (the user must be a member).
after: only files with last_edit > after (newer).
before: only files with last_edit < before (older); use the smallest last_edit from a previous page to get the next page.
filetype: only files with the given file type(s).

## Query parameters

- `path` string
- `limit` integer
- `group_id` string, uuid, nullable
- `before` string, date-time, nullable
- `after` string, date-time, nullable
- `filetype` FileType[], nullable

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- FileReference[]
  - `file_name` string, required
  - `is_folder` boolean, required
  - `file_id` string, nullable, required
  - `file_type` string, nullable, required
  - `mime_type` string, nullable
  - `duration_seconds` number, nullable
  - `last_edit` string, date-time, required
  - `right` 'ADMIN' | 'READ' | 'WRITE' | 'VIEW': A right on an asset, a chat or an assistant, weakest first: VIEW < READ < WRITE < ADMIN. On an asset, VIEW sees the file and everything about it except its comments, which READ adds. Chats and assistants have nothing READ adds, so VIEW opens what READ does there. Group memberships start at READ.
  - `preview_frames` PreviewFrame[], nullable
    - `asset_id` string, required
    - `frame_time` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)