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

# Make a folder

`POST /tables/folders/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/tables/folders/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Make a folder, at the top level or inside parent_id. Leave the name out for "Untitled folder". Names are unique among a folder's live siblings, case aside. Whoever makes it owns it.

## Request body

- TableFolderCreateSchema: Request body for making a folder.
  - `name` string, nullable: The folder's name. Leave it out for "Untitled folder", numbered when the place already has one.
  - `parent_id` string, uuid, nullable: The folder to make it in; null for the top level.

## Response `201`

Successful Response

- TableFolderSchema: A workspace folder, as the Tables list draws it.
  - `created_at` string, date-time, required
  - `folder_count` integer: Folders directly in it.
  - `id` string, uuid, required
  - `last_viewed_at` string, date-time, nullable: When the CALLING USER last opened any table in it, at any depth; null when they never have.
  - `name` string, required
  - `nested_archived_count` integer: Archived tables in it at any depth, which go to Trash with it too.
  - `nested_table_count` integer: Tables in it at any depth, archived ones aside. What deleting it would send to Trash, archived tables added.
  - `owner_display_name` string, nullable: The owner's name, resolved for display.
  - `owner_user_id` string, nullable, required: Who to ask about it: whoever made it, unless somebody changed it.
  - `parent_id` string, uuid, nullable, required: The folder it sits in; null for the top level.
  - `table_count` integer: Tables directly in it, archived ones aside.
  - `updated_at` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Parent folder not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)