---
title: "Browse remote folders"
method: GET
path: "/connectors/v1/connections/{id}/browse"
tags: ["Connectors"]
---

# Browse remote folders

`GET /connectors/v1/connections/{id}/browse`

## Request

- Base URL: `https://api.case.dev`
- URL: `https://api.case.dev/connectors/v1/connections/{id}/browse`
- Auth: HTTP bearer

Browse the provider one level at a time. Without a site, container, or parent, returns top-level resources. Pass the stable browse_ref fields returned by one response to navigate into the next level. Returns 403 provider_scope_insufficient when the connection scope cannot browse server-side. Clio browsing shares request capacity with background runs; throttled responses include Retry-After when a retry deadline is known.

## Path parameters

- `id` string, required

## Query parameters

- `site` string
- `parent` string
- `container` string
- `query` string
- `cursor` string
- `page_size` integer

## Headers

- `x-case-connector-subject` string

## Response `200`

One browse level

- object
  - `items` object[]
    - `id` string
    - `name` string
    - `description` string, nullable
    - `kind` 'my_drive' | 'shared_drive' | 'matter' | 'site' | 'document_library' | 'folder' | 'file'
    - `mime_type` string, nullable
    - `size_bytes` integer, nullable
    - `modified_at` string, nullable
    - `path` string, nullable
    - `container_id` string, nullable
    - `parent_ids` string[]
    - `browse_ref` object, nullable
    - `import_ref` object, nullable: Importable container root, when different from its browse reference.
    - `open_ref` string, nullable: Signed reference to this file for POST /connectors/v1/fetch. Null for folders and providers without single-file fetch. Pass it back exactly as received.
  - `cursor` string, nullable

## Other responses

- `400`: Unsupported browse level or invalid query parameters
- `401`: Invalid API key
- `403`: Insufficient permissions or provider_scope_insufficient
- `404`: Connection or folder not found
- `409`: Connection is not healthy (reauth required)
- `429`: Provider request budget exhausted; Retry-After specifies seconds to wait when known

## Changes

- **2026-10-28** `0342b8b0c63b`: 1 info
  - added the optional property `items/items/open_ref` to the response with the `200` status
- **2026-10-16** `a21d188f4b21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casemark/apis/case-dev-api/changes/connectors/v1/connections/:id/browse/get.md)

---

[API](https://skmtc.dev/casemark/apis/case-dev-api.md) - [All operations](https://skmtc.dev/casemark/apis/case-dev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/casemark/apis/case-dev-api/revisions/9a3245c00044?raw)