---
title: "Search Folder"
method: GET
path: "/api/folders/search"
tags: ["folders"]
---

# Search Folder

`GET /api/folders/search`

## Request

- Base URL: `https://app.ctlsurf.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ctlsurf.com/api/folders/search`
- Auth: HTTP bearer

Find a folder by path, git URL, or name.

Args:
    query: The search value
    type: One of:
        - 'path': Search by local filesystem root_path
        - 'url': Search by git remote URL (e.g., https://github.com/user/repo)
        - 'name': Search by folder name (partial match)

## Query parameters

- `query` string, required: The search value
- `type` string, required: Search type: 'path' (local filesystem), 'url' (git remote URL), or 'name' (folder name text search)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ctlsurf/apis/notebook-control-plane.md) · [All operations](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/revisions/ddfbbe20d5ce?raw)