Folders

Operations about folders

Retrieve folders

get

Retrieve folders within a project. Supports filtering, sorting, field selection, and pagination.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

projectIdstringRequired

The ID of the project.

Query parameters

filterstringOptional

JSON-encoded filter object. Supported fields — parentFolderId, name, tags (array of tag names), excludeFolderIdAndDescendants.

Example: {"parentFolderId":"abc123","name":"My Folder"}

selectstringOptional

JSON-encoded array of fields to include. Valid fields — id, name, createdAt, updatedAt, project, tags, parentFolder, workflowCount, subFolderCount, path.

Example: ["id","name","tags","workflowCount"]

sortBystring · enumOptional

Sort order for results.

Possible values:

skipstringOptional

Number of items to skip for pagination. Defaults to 0.

takestringOptional

Number of items to return. Defaults to 10.

Responses

200

Operation successful.

application/json

countintegerOptional

Total number of folders matching the query.

400

The request is invalid or provides malformed data.

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

get/projects/{projectId}/folders

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/folders HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "data": [
    {
      "id": "text",
      "name": "My Folder",
      "parentFolderId": "text",
      "createdAt": "2026-07-19T15:34:20.583Z",
      "updatedAt": "2026-07-19T15:34:20.583Z"
    }
  ]
}

Create a folder

post

Create a folder within a project.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

projectIdstringRequired

The ID of the project.

Body

application/json

namestringRequiredExample: My Folder

parentFolderIdstringOptionalExample: abc123

Responses

201

Operation successful.

application/json

idstringRead-onlyOptional

namestringOptionalExample: My Folder

parentFolderIdstring · nullableOptional

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

400

The request is invalid or provides malformed data.

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

post/projects/{projectId}/folders

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/folders HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "name": "My Folder",
  "parentFolderId": "abc123"
}

{
  "id": "text",
  "name": "My Folder",
  "parentFolderId": "text",
  "createdAt": "2026-07-19T15:34:20.583Z",
  "updatedAt": "2026-07-19T15:34:20.583Z"
}

Get folder details

get

Get folder details including sub-folder and workflow counts.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

projectIdstringRequired

The ID of the project.

folderIdstringRequired

The ID of the folder.

Responses

200

Operation successful.

application/json

idstringRead-onlyOptional

namestringOptional

parentFolderIdstring · nullableOptional

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

totalSubFoldersintegerOptional

Total number of sub-folders (recursive).

totalWorkflowsintegerOptional

Total number of workflows (recursive).

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

get/projects/{projectId}/folders/{folderId}

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/folders/{folderId} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "name": "text",
  "parentFolderId": "text",
  "createdAt": "2026-07-19T15:34:20.583Z",
  "updatedAt": "2026-07-19T15:34:20.583Z",
  "totalSubFolders": 1,
  "totalWorkflows": 1
}

Delete a folder

delete

Delete a folder within a project. When transferToFolderId is provided, workflows and sub-folders are moved to the target folder before deletion. When omitted, workflows are moved to the project root and archived, and child folders are deleted.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

projectIdstringRequired

The ID of the project.

folderIdstringRequired

The ID of the folder.

Query parameters

transferToFolderIdstringOptional

Optional target folder ID to move workflows and sub-folders into before deleting.

Responses

204

Operation successful.

No content

400

The request is invalid or provides malformed data.

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

delete/projects/{projectId}/folders/{folderId}

HTTPcURLJavaScriptPython

DELETE /api/v1/projects/{projectId}/folders/{folderId} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

No content

Update a folder

patch

Update folder name or parent folder.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Path parameters

projectIdstringRequired

The ID of the project.

folderIdstringRequired

The ID of the folder.

Body

application/json

namestringOptionalExample: Renamed Folder

parentFolderIdstringOptionalExample: abc123

Responses

200

Operation successful.

application/json

idstringRead-onlyOptional

namestringOptionalExample: My Folder

parentFolderIdstring · nullableOptional

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

400

The request is invalid or provides malformed data.

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

patch/projects/{projectId}/folders/{folderId}

HTTPcURLJavaScriptPython

PATCH /api/v1/projects/{projectId}/folders/{folderId} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "name": "Renamed Folder",
  "parentFolderId": "abc123"
}

{
  "id": "text",
  "name": "My Folder",
  "parentFolderId": "text",
  "createdAt": "2026-07-19T15:34:20.583Z",
  "updatedAt": "2026-07-19T15:34:20.583Z"
}