---
title: "Create Insights Upload Folder"
method: POST
path: "/api/v1/insights/folders/"
tags: ["insights.folders"]
---

# Create Insights Upload Folder

`POST /api/v1/insights/folders/`

## Request body

- InsightsFolderInput — Request model to create/update an insight upload folder.
  - `name` string, required — Human-readable name of insight folder
  - `label` string, nullable — optional label assigned to insight folder
  - `description` string, nullable — Text description of insight upload folder

## Response `200`

Successful Response

- InsightsFolder — Response model for an insight upload folder.
  - `name` string, required — Human-readable name of insight folder
  - `label` string, nullable — optional label assigned to insight folder
  - `description` string, nullable — Text description of insight upload folder
  - `id` integer, required — System-assign folder ID
  - `created_at` string, date-time — Timestamp at which insight upload folder was created
  - `updated_at` string, date-time — Timestamp at which insight upload folder was last updated
  - `last_updated_by` string, required — Email of user who last updated upload folder

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/versions/ac3228f980bb/schema)