> ## 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. # Create a remote folder > Create one folder at the provider directly under a browse location, then export into it with POST /connectors/v1/transfer. Name the parent with the same site, container, and parent fields browse accepts (for Clio and Smokeball, a matter root is the browse_ref the matter returned). A folder of the same name already under the parent is returned with 200 instead of a duplicate; a new folder returns 201. Smokeball creates folders asynchronously: when the new folder is not listed yet the response is 202 with code folder_creation_pending and no folder, and repeating the same request returns it without creating another. Returns 403 provider_scope_insufficient when the connection was granted read access only; reconnect with write access. ## OpenAPI ````yaml /openapi.json post /connectors/v1/connections/{id}/folders 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}/folders: post: tags: - Connectors summary: Create a remote folder description: >- Create one folder at the provider directly under a browse location, then export into it with POST /connectors/v1/transfer. Name the parent with the same site, container, and parent fields browse accepts (for Clio and Smokeball, a matter root is the browse_ref the matter returned). A folder of the same name already under the parent is returned with 200 instead of a duplicate; a new folder returns 201. Smokeball creates folders asynchronously: when the new folder is not listed yet the response is 202 with code folder_creation_pending and no folder, and repeating the same request returns it without creating another. Returns 403 provider_scope_insufficient when the connection was granted read access only; reconnect with write access. operationId: createConnectorFolder 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 requestBody: required: true content: application/json: schema: type: object required: - name properties: name: type: string description: >- Folder name. Trimmed; 1-255 characters; no '/', '\', or control characters; not '.' or '..'. Providers may refuse further characters. site: type: string description: Site id of the parent, from its browse_ref container: type: string description: Container id of the parent, from its browse_ref parent: type: string description: >- Folder id of the parent, from its browse_ref. Omit for a container root. responses: '200': description: >- A folder of that name already existed under the parent; returned as is '201': description: Folder created content: application/json: schema: type: object properties: status: type: string enum: - created - existing - pending code: type: string nullable: true description: >- folder_creation_pending with status pending; otherwise null folder: type: object nullable: true description: >- The folder as browse returns it, including the browse_ref to export into. Null while pending. properties: id: type: string name: type: string description: type: string nullable: true kind: type: string enum: - folder 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 browse_ref: type: object nullable: true import_ref: type: object nullable: true open_ref: type: string nullable: true '202': description: >- folder_creation_pending: the provider accepted the folder but does not list it yet. Repeat the request to get it. '400': description: >- invalid_folder_name, folder_parent_required, unsupported_browse_ref, or folder_creation_unsupported (the provider cannot create folders in this deployment) '401': description: Invalid API key '403': description: >- Insufficient permissions, connector disabled, or provider_scope_insufficient (reconnect with write access) '404': description: Connection or parent folder not found '409': description: Connection is not healthy (reauth required) '429': description: >- Provider request budget exhausted; Retry-After specifies seconds to wait when known headers: Retry-After: schema: type: integer description: Seconds before retrying '502': description: provider_error 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.