Skip to main content
POST
/
v2
/
hc-folders
/
public
Create knowledge folder
curl --request POST \
  --url https://api-prod.usefini.com/v2/hc-folders/public \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "parentFolderId": "<string>"
}
'
Use this route to add a new folder to the knowledge tree.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
​
Content-Type
string
required
application/json

​
Body parameters

​
title
string
required
Folder title.
​
description
string
required
Folder description. Can be an empty string.
​
parentFolderId
string
Parent folder ID for nesting. Omit for a top-level folder.

​
Response

Returns the created knowledge folder object. See Organize knowledge for the shared folder fields.

​
Errors

The request body is malformed.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope.
The parent folder does not exist, or you attempted a structure change the tree does not allow.