---
title: "Create Folder"
method: POST
path: "/asset/folder"
tags: ["accepts-api-key"]
---

# Create Folder

`POST /asset/folder`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/asset/folder`
- Auth: none declared

Create a folder. Either at a path (body.path) or under a parent folder (body.parent_asset_id + body.name).
Path-based: ensures folder and ancestors exist for the user's default group.
Parent-based: parent must be a folder the user has WRITE access to.
Callable with API key (X-Api-Key header) or Bearer token.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- CreateFolderRequest: Either provide path (create at path) or parent_asset_id + name (create under parent).
  - `path` string, nullable
  - `parent_asset_id` string, uuid, nullable
  - `name` string, nullable

## Response `201`

Successful Response

- CreateFolderResponse
  - `id` string, required
  - `path` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)