> ## Documentation Index
> Fetch the complete documentation index at: https://docs.case.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search remote files

> Search the provider's files by name, and by content where the provider supports it. Without a scope, searches everything the connection can see; pass the browse_ref fields of a folder or container to search inside it. Each response states whether its folder scope covers the whole subtree. Returns 422 search_not_supported when the provider has no search, and shares the provider request budget with browsing and background runs.



## OpenAPI

````yaml /openapi.json get /connectors/v1/connections/{id}/search
openapi: 3.1.0
info:
  title: Case.dev API
  description: >-
    The AI-native platform for legal technology. Build smarter legal
    applications with our suite of AI-powered APIs.
  version: 1.0.0
  contact:
    name: Case.dev Support
    email: support@casemark.com
    url: https://case.dev
  license:
    name: Proprietary
    url: https://case.dev/terms
servers:
  - url: https://api.case.dev
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Vaults
    description: Secure document storage with semantic search
  - name: Vault Events
    description: Vault-scoped event subscriptions and delivery testing
  - name: Vault Memory
    description: Vault-scoped persistent memory and semantic retrieval
  - name: Vault Objects
    description: Vault object management, content access, and document operations
  - name: Memory
    description: >-
      Persistent memory for AI agents with semantic search and 12 generic
      indexed tag fields
  - name: OCR
    description: Extract text from PDFs, images, and scanned documents
  - name: Voice
    description: Audio transcription and text-to-speech
  - name: LLMs
    description: Access 40+ language models through a unified API
  - name: Search
    description: Web search and AI answers
  - name: Mail
    description: Managed inboxes for agent email workflows
  - name: Media
    description: Transcript retrieval and captioned media clip generation
  - name: Legal
    description: Legal research tools including citation verification
  - name: Privilege
    description: Privilege detection for e-discovery and litigation workflows
  - name: Compute
    description: Serverless GPU and CPU infrastructure
  - name: Format
    description: Document formatting and template rendering (MD/JSON to PDF/DOCX)
  - name: SuperDoc
    description: Document conversion and template automation
  - name: Webhooks
    description: Webhook endpoint management
  - name: System
    description: Public system metadata and discovery endpoints
  - name: Usage
    description: Usage reporting and webhook subscriptions
  - name: Database
    description: Serverless PostgreSQL databases with instant branching
  - name: Translation
    description: Language detection and translation for multilingual legal workflows
  - name: Skills
    description: Search and read legal AI skills for agents
  - name: Agents/Linc
    description: Durable, stateful legal agent sessions with sandboxed tools and files
  - name: Matters
    description: Matter-native legal workspaces and orchestration primitives
  - name: Connectors
    description: Import and export between provider folders and vaults
  - name: Applications Projects
    description: Web application project management
  - name: Applications Deployments
    description: Web application deployment management
  - name: Applications Domains
    description: Custom domain configuration for applications
  - name: Applications Env Vars
    description: Environment variable management for applications
paths:
  /connectors/v1/connections/{id}/search:
    get:
      tags:
        - Connectors
      summary: Search remote files
      description: >-
        Search the provider's files by name, and by content where the provider
        supports it. Without a scope, searches everything the connection can
        see; pass the browse_ref fields of a folder or container to search
        inside it. Each response states whether its folder scope covers the
        whole subtree. Returns 422 search_not_supported when the provider has no
        search, and shares the provider request budget with browsing and
        background runs.
      operationId: searchConnectorConnection
      parameters:
        - name: x-case-connector-subject
          in: header
          schema:
            type: string
            pattern: ^[A-Za-z0-9_-]{1,255}$
          description: >-
            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.
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: query
          in: query
          required: true
          schema:
            type: string
            maxLength: 256
          description: Search text
        - name: site
          in: query
          schema:
            type: string
          description: Site to search in
        - name: container
          in: query
          schema:
            type: string
          description: Container to search in, or the container holding parent
        - name: parent
          in: query
          schema:
            type: string
          description: Folder to search in
        - name: cursor
          in: query
          schema:
            type: string
        - name: page_size
          in: query
          schema:
            type: integer
            maximum: 1000
      responses:
        '200':
          description: One page of matching files
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        kind:
                          type: string
                          enum:
                            - file
                        mime_type:
                          type: string
                          nullable: true
                        size_bytes:
                          type: integer
                          nullable: true
                        modified_at:
                          type: string
                          nullable: true
                        path:
                          type: string
                          nullable: true
                        container_id:
                          type: string
                          nullable: true
                        parent_ids:
                          type: array
                          items:
                            type: string
                        unsupported_reason:
                          type: string
                          nullable: true
                          description: >-
                            Set when the file cannot be imported (for example a
                            Box note)
                  cursor:
                    type: string
                    nullable: true
                  scope:
                    type: string
                    enum:
                      - account
                      - folder
                  scope_ref:
                    type: object
                    nullable: true
                  full_text:
                    type: boolean
                    description: Whether the provider matches file contents, not only names
                  folder_scope_recursive:
                    type: boolean
                    description: False when a folder scope covers its direct children only
        '400':
          description: Missing query or unsupported scope reference
        '401':
          description: Invalid API key
        '403':
          description: Insufficient permissions or provider_scope_insufficient
        '404':
          description: Connection or folder not found
        '409':
          description: Connection is not healthy (reauth required)
        '422':
          description: search_not_supported or search_scope_not_supported
        '429':
          description: >-
            Provider request budget exhausted; Retry-After specifies seconds to
            wait when known
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds before retrying
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.