---
title: "Create list"
method: POST
path: "/projects/{project_id}/lists"
tags: ["project"]
---

# Create list

`POST /projects/{project_id}/lists`

## Request

- Base URL: `https://api.ora.pm`
- URL: `https://api.ora.pm/projects/{project_id}/lists`
- Auth: OAuth 2
  - Authorization code: `https://app.ora.pm/authorize`
  - Token URL: `https://api.ora.pm/oauth/token` scopes: `read`, `write`

## Request body

- CreateList
  - `title` string, required: Title of the list.
  - `color` string: Color of the list.
  - `list_type` integer: Type of the list. 1 - Open, 2 - Closed, 3 - Review and 4 - Frosen.
  - `public` boolean: If true the list is public, if false - private.

## Response `200`

OK

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

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