POST /knowledge/folders

Updated Oct 1, 20261 minute read

Create a folder

A new shelf, at the bottom of wherever it goes. Folders nest three levels deep and no further.

Part of Knowledge.

Request body

application/json, required.

Field	Type	Required
`name`	`string`	Yes
`description`	`string`	No
`parentId`	`string`	No

Status	Description
`200`	Created.
`400`	The request is malformed, and the message names the field.
`401`	The bearer token is missing, revoked, or expired.
`403`	The token's person does not hold the role this needs.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`id`	`string`	No

curl -X POST https://api.median.sh/v1/knowledge/folders \
  -H "Authorization: Bearer $BEARER_AUTH"