---
title: "browse"
method: POST
path: "/connections/browse"
tags: ["Connection"]
---

# browse

`POST /connections/browse`

Browse resources in a connection. Eg list directories/files in a s3 bucket, list tables in a database, list topics in a Kafka cluster etc.

## Request body

- Request
  - `connection` ConnectionApi
    - `type` string
    - `params` object
  - `path` string

## Response `200`

List of keys based on input locator

- Response
  - `items` ItemApi[]
    - `name` string
    - `type` 'DIR' | 'FILE' | 'TABLE' | 'TOPIC'

## Other responses

- `500` — Internal error

---

[API](https://skmtc.net/startree/apis/pinot-controller-api.md) · [All operations](https://skmtc.net/startree/apis/pinot-controller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/startree/pinot-controller-api/revisions/f1cc8a0ba2e0/schema)