Search remote files and folders

{ "items": [ { "id": "<string>", "name": "<string>", "kind": "file", "mime_type": "<string>", "size_bytes": 123, "modified_at": "<string>", "path": "<string>", "container_id": "<string>", "parent_ids": [ "<string>" ], "browse_ref": {}, "unsupported_reason": "<string>", "open_ref": "<string>" } ], "cursor": "<string>", "scope": "account", "scope_ref": {}, "full_text": true, "folder_scope_recursive": true }

Authorizations

Authorization

string

header

required

API key starting with sk_case_

Headers

x-case-connector-subject

string

Trusted server-to-server application-user assertion. Derive it from the authenticated application session, never browser input. Omit only for the legacy organization-scoped namespace.

Pattern: ^[A-Za-z0-9_-]{1,255}$

Path Parameters

string

required

Query Parameters

query

string

required

Search text

Maximum string length: 256

kind

enum<string>

default:file

What to search for: files, or folders by name

Available options:

file,

folder

site

string

Site to search in

container

string

Container to search in, or the container holding parent

parent

string

Folder to search in

cursor

string

page_size

integer

Required range: x <= 1000

Response

One page of matching files or folders

items

object[]

Show child attributes

cursor

string | null

scope

enum<string>

Available options:

account,

folder

scope_ref

object | null

full_text

boolean

Whether the provider matches file contents, not only names. Always false for kind=folder.

folder_scope_recursive

boolean

False when a folder scope covers its direct children only

Compute

Connectors

System

Legal

Agents/Linc

LLMs

Matters

Media

Memory

OCR

Privilege

Search

Skills

Translation

Usage

Vaults

Vault Objects

Vault Events

Vault Memory

Voice

Webhooks

Search remote files and folders

Authorizations

Headers

Path Parameters

Query Parameters

Response