# Create a List

> Creates a private or Public List of one kind for the user.

`POST /account/lists` on `https://api.mediux.io`

`kind` is `assetList`, `mediaList` or `gameList` (the `/config` `listKinds`). `name` takes up to 80 characters and `description` up to 500; `isPublic` defaults to `false`. Public Lists appear on the user's profile. A user can own 100 Lists (`409` `list.limit.lists`).

## Authorization

OAuth 2 bearer token in the `Authorization` header. Required permission: `lists:write`.

## Request body (`application/json`)

- `name` (string, required)
- `description` (string, nullable)
- `kind` (string, required): One of "assetList", "mediaList", "gameList".
- `isPublic` (boolean)

## Responses

### 201

The new List.

- `data` (object, required)

### 400

The request is malformed or failed validation. Inspect `error.code` and `error.issues`.

### 401

The access token is missing (`auth.required`), or invalid, expired or revoked (`auth.invalidToken`).

### 403

The token lacks the required App Permission (`auth.insufficientScope`, with `details.required`), or the account or connection may not do this (`auth.forbidden`).

### 409

The request conflicts with current state or a limit. Inspect `error.code` and `error.details`.

### 413

The body exceeds the allowed size.

### 415

The `Content-Type` is not `application/json`.

### 429

Too many requests. Wait the `Retry-After` seconds before trying again.

### 503

Temporarily unavailable. Check the outcome before retrying a write.

## Example response (201)

```json
{
  "data": {
    "kind": "assetList",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "name",
    "description": "A short description.",
    "owner": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "username": "username"
    },
    "itemCount": 0,
    "subscriberCount": 0,
    "createdAt": "createdAt",
    "updatedAt": "updatedAt",
    "items": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "extension": "extension",
        "slot": "poster",
        "entity": {
          "kind": "show",
          "id": 1
        },
        "language": "en",
        "edition": "theatricalCut",
        "width": 1,
        "height": 1,
        "fileSize": 0,
        "set": {
          "kind": "showSet",
          "id": 1
        },
        "creator": {
          "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
          "username": "username"
        },
        "createdAt": "createdAt",
        "updatedAt": "updatedAt"
      }
    ]
  }
}
```
