---
title: "Make a folder"
method: POST
path: "/api/folders"
tags: ["Folders"]
---

# Make a folder

`POST /api/folders`

## Request

- Base URL: `https://morfee.furo.solutions`
- URL: `https://morfee.furo.solutions/api/folders`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP bearer

Needs a key scoped `write` or `full`.

## Request body

- object
  - `name` string, required

## Response `200`

The folder.

- object
  - `ok` boolean
  - `folder` Folder
    - `id` string, required
    - `name` string, required
    - `templates` integer: How many templates sit on this shelf.
    - `createdAt` string, date-time

## Other responses

- `400`: Something in the request is wrong, and the message says what.
- `401`: No key, an unknown key or a revoked one.
- `403`: The key is real and the organization is right, but the scope on it does not cover this. The message names the scope the key has, what that scope may do, and how to get a wider one, because the thing reading it is usually the thing that has to act on it.

---

[API](https://skmtc.dev/furo/apis/morfee.md) · [All operations](https://skmtc.dev/furo/apis/morfee/llms.txt) · [OpenAPI document](https://skmtc.dev/furo/apis/morfee/revisions/83f95f89653f?raw)