---
title: "Get the file paths on a system"
method: GET
path: "/v1/agent/{agent_id}/file-search"
tags: ["Agents"]
---

# Get the file paths on a system

`GET /v1/agent/{agent_id}/file-search`

## Path parameters

- `agent_id` string, required — ID of an agent

## Query parameters

- `offset` integer
- `limit` integer
- `sort_by` 'path' | 'last_modified' | 'file_size'
- `sort_asc` boolean
- `search_term` string, required

## Response `200`

OK

- object
  - `data` FileIndexSearch[], required — List of file paths that match search criteria
    - `modified_time` string, date-time, required — the time when the file was modified in the most recent snapshot
    - `path` string, required — path to a file on the protected system
    - `size` integer, required — size of the file in bytes
  - `pagination` Pagination, required
    - `next_offset` integer — Next offset to use for pagination. If this field is not present, that indicates there are no more items to fetch.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/slide/apis/slide-api.md) · [All operations](https://skmtc.net/slide/apis/slide-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slide/slide-api/versions/c63e4b604dd1/schema)