> ## 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. # List every file in a folder > List every file under one folder, at any depth, as a flat paginated list, to preview what importing that folder would bring in. Pass the browse_ref fields of a folder or container. Each file carries its path relative to that folder. A page returns as soon as it holds files, so it may be shorter than page_size while cursor is still set; keep requesting until cursor is null. The listing stops after 10,000 files and sets truncated. Returns 422 contents_not_supported when the provider cannot list folder contents, and shares the provider request budget with browsing and background runs. ## OpenAPI ````yaml /openapi.json get /connectors/v1/connections/{id}/contents 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}/contents: get: tags: - Connectors summary: List every file in a folder description: >- List every file under one folder, at any depth, as a flat paginated list, to preview what importing that folder would bring in. Pass the browse_ref fields of a folder or container. Each file carries its path relative to that folder. A page returns as soon as it holds files, so it may be shorter than page_size while cursor is still set; keep requesting until cursor is null. The listing stops after 10,000 files and sets truncated. Returns 422 contents_not_supported when the provider cannot list folder contents, and shares the provider request budget with browsing and background runs. operationId: listConnectorConnectionContents 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: site in: query schema: type: string description: Site of the folder - name: container in: query schema: type: string description: Container to list, or the container holding parent - name: parent in: query schema: type: string description: Folder to list - name: cursor in: query schema: type: string - name: page_size in: query schema: type: integer minimum: 1 maximum: 1000 default: 1000 responses: '200': description: One page of files under the folder 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 description: >- Path relative to the listed folder, ending in the file's name container_id: type: string nullable: true parent_ids: type: array items: type: string unsupported_reason: type: string nullable: true description: >- Set when an import would skip the file (for example a Box note) open_ref: type: string nullable: true description: >- Signed reference to this file for POST /connectors/v1/fetch. Null for providers without single-file fetch. Pass it back exactly as received. cursor: type: string nullable: true truncated: type: boolean description: >- True when the listing stopped before every file was listed, at the 10,000-file limit or because the folder tree was too wide to page through scope_ref: type: object description: The listed folder, as a browse_ref '400': description: Missing folder, unsupported reference, or invalid cursor '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: contents_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.