Create a new folder

POST 
/api/v1/storage/create-folder

Creates the requested folder entry at the specified path. It does not create intermediate parent entries; create those explicitly when needed.

The following access conditions are preserved as declared intent and are not implemented by generated code: Accepted storage owner context, Storage owner actor routing.

Use this in a guide: Organize a customer’s project documents

Request

Responses

200

Folder created (or already existed)

Create a reports folder in the authenticated user’s storage namespace.

Section ID: DOC-CP-files-data-api-createFolder#example-storage-createFolder-request

Request example

{
  "folderPath": "reports"
}

Guide request for Prepare a folder and add the first document. Replace example resource identifiers with your own authorized values.

Section ID: DOC-CP-files-data-api-createFolder#example-cookbook-core-platform-files-data-folders-01-request

Request example

{
  "folderPath": "/documents/work"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-CP-files-data-api-createFolder#example-storage-createFolder-response

Response example

{
  "folder": {
    "folderId": "example_123",
    "name": "example",
    "path": "documents/example.txt",
    "parentPath": "documents/example.txt",
    "createdAt": "example",
    "modifiedAt": "example",
    "metadata": {},
    "fileCount": 1,
    "subfolderCount": 1,
    "totalSizeBytes": "1"
  },
  "created": true
}

Document ID: DOC-CP-files-data-api-createFolder. Section identities and revisions.

Section	Stable reference
Create a new folder	DOC-CP-files-data-api-createFolder#overview
Request	DOC-CP-files-data-api-createFolder#request
Responses	DOC-CP-files-data-api-createFolder#responses