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.
Authorizations
API key starting with sk_case_
Headers
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.
^[A-Za-z0-9_-]{1,255}$Path Parameters
Body
Folder name. Trimmed; 1-255 characters; no '/', '', or control characters; not '.' or '..'. Providers may refuse further characters.
Site id of the parent, from its browse_ref
Container id of the parent, from its browse_ref
Folder id of the parent, from its browse_ref. Omit for a container root.
Response
A folder of that name already existed under the parent; returned as is

