---
title: "Resolve a full folder chain and prefetch its contents"
method: POST
path: "/container/tree/resolve_path"
tags: ["Raw Search"]
---

# Resolve a full folder chain and prefetch its contents

`POST /container/tree/resolve_path`

Resolve an entry path by hydrating every folder segment leading to it.

The resolver fetches the immediate subfolders and a page of files for each segment in the chain. It also can prefetch parts around a target sequence.

## Request body

- ResolvePathRequest
  - `container_id` integer, required — Identifier of the container that owns the entry.
  - `entry_path` string — Entry path to resolve from the root of the container.
  - `options` ResolvePathOptions
    - `prefetch_files` boolean — Whether the resolver should prefetch the first page of files for each segment.
    - `max_subfolders` integer — Maximum number of subfolders to fetch per segment.
    - `file_page_size` integer — Page size used when prefetching files for each segment.
    - `prefetch_parts` ResolvePathPrefetchParts
      - `seq` integer, required — Sequence number to centre the prefetched window around.
      - `limit` integer, nullable — Number of parts to retrieve around the target sequence.

## Response `200`

Folder chain resolved successfully.

- ResolvePathResponse
  - `container_id` string, required — Identifier of the container that owns the resolved path.
  - `entry_path` string, required — Entry path requested by the caller.
  - `segments` ResolvePathSegment[], required — Ordered list of segments composing the folder chain.
    - `prefix` string, required — Folder prefix represented by this segment.
    - `subfolders` string[] — Immediate subfolders available under the prefix.
    - `subfolders_truncated` boolean — True when more subfolders are available beyond the prefetched slice.
    - `files` ResolvePathFiles
      - `items` TreeEntry[], required — Entries included in the prefetched slice.
        - `entry_path` string, required — Entry path inside the container.
        - `entry_name` string, nullable — Base name of the entry, when present.
        - `ext` string, nullable — File extension for the entry.
        - `size_bytes` integer, nullable — Size of the entry in bytes, when known.
        - `mtime` string, nullable — Last modification timestamp.
      - `total` integer, required — Total number of entries reported for the segment.
      - `page` integer, required — Page index of the prefetched slice.
      - `page_size` integer, required — Maximum number of entries returned in the slice.
  - `target_entry` TreeEntry
    - `entry_path` string, required — Entry path inside the container.
    - `entry_name` string, nullable — Base name of the entry, when present.
    - `ext` string, nullable — File extension for the entry.
    - `size_bytes` integer, nullable — Size of the entry in bytes, when known.
    - `mtime` string, nullable — Last modification timestamp.
  - `target_parts` PartsResponse
    - `items` PartsItem[], required — Sequence of parts found for the requested slice.
      - `seq` integer, required — Sequential part number within the entry.
      - `size_bytes` integer, nullable — Size of the block in bytes, when recorded.
      - `offset` integer, nullable — Byte offset of the block within the entry.
      - `ingested_at` string, nullable — ISO timestamp of the ingestion time for the block.
    - `total` integer, required — Total number of parts available for the entry.
    - `page` integer, required — Requested page index (1-based).
    - `page_size` integer, required — Number of parts returned in this page.
    - `window` PartsWindow
      - `start_index` integer, required — Index (0-based) of the first part present in the window.
      - `end_index` integer, required — Index (0-based) of the last part present in the window.
    - `container_id` string, required — Identifier of the container queried.
    - `entry_path` string, required — Entry path for which the parts are listed.

## Other responses

- `401` — Authentication required, or invalid/expired API key.
- `403` — Account banned, or pending email verification.
- `404` — Folder or entry not found.
- `422` — Validation Error
- `429` — Rate limit exceeded. See Retry-After / X-RateLimit-* headers.
- `500` — Search query failed.
- `503` — Raw search under maintenance, or public API temporarily disabled.

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leakradar/leakradar-io-api/revisions/82a99c608e1a/schema)