---
title: "Open native folder picker"
method: POST
path: "/v1/rag/browse-folder"
tags: ["RAG"]
---

# Open native folder picker

`POST /v1/rag/browse-folder`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/rag/browse-folder`
- Auth: HTTP bearer

Opens a macOS native folder picker dialog. Returns the selected path
and a security-scoped bookmark (base64) for sandbox access.

## Response `200`

Folder selected

- object
  - `path` string, required: Absolute path to the selected folder
  - `bookmark` string, required: Base64-encoded security-scoped bookmark

## Other responses

- `204`: User cancelled the folder picker

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)