Skip to main content
GET
/
filesystem-find
/
{path}
Find files and directories
curl --request GET \
  --url https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/filesystem-find/{path} \
  --header 'Authorization: Bearer <token>'
{
  "matches": [
    {
      "path": "src/main.go",
      "type": "file"
    }
  ],
  "total": 5
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
path
string
required

Path to search in (e.g., /home/user/projects)

Query Parameters

​
type
string

Type of search (file or directory)

​
patterns
string

Comma-separated file patterns to include (e.g., .go,.js)

​
maxResults
integer

Maximum number of results to return (default: 20). If set to 0, all results will be returned.

​
excludeDirs
string

Comma-separated directory names to skip (default: node_modules,vendor,.git,dist,build,target,pycache,.venv,.next,coverage). Use empty string to skip no directories.

​
excludeHidden
boolean

Exclude hidden files and directories (default: true)

Response

Find results

​
matches
object[]
​
total
integer
Example:

5