/bff/drive/create-directory

Creates a new directory (and any missing parent directories) at the specified path. If the directory already exists, returns the existing directory info without error. Directory names must be unique within their parent folder.

DrivepostBffDriveCreate-directory

Parameters

JSON body

Request body

application/json

pathstringRequired

Full directory path to create. Segments separated by "/" will create nested directories. Each segment name must be unique within its parent directory.

Exampledocuments/invoices

Response schema

1 status code documented

200SuccessCreated (or existing) directory information.

externalIdstringRequired

Unique external identifier of the created directory.

namestringRequired

Name of the leaf directory.

pathstringRequired

Full normalized path of the created directory.

Response example

application/json

{
  "externalId": "example_externalId",
  "name": "example_name",
  "path": "example_path"
}

Request example

POST /bff/drive/create-directory

post

curl -X POST "https://api.bizkithub.com/bff/drive/create-directory" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "path": "documents/invoices"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key