# Add Assets to an Asset List

> Adds Assets (single community images) to an Asset List the user owns.

`POST /account/lists/{id}/assets` on `https://api.mediux.io`

An Asset already on the List counts as `existing`. An Asset List holds about 1,000 images (`409` `list.limit.images`). An Asset that no longer exists is `404` `list.itemUnavailable`; one that can't go on a List, such as a Boxset or Loadout poster, is `409` `list.itemIneligible`; Assets on a Media or Game List are `409` `list.kindMismatch`. A change is all or nothing. Making a List public or private takes effect at once; other changes to a Public List can take up to an hour to show on the public List routes.

## Authorization

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

## Parameters

- `id` (path, string, required): The List's ID (a lowercase UUID). A List the user neither owns nor subscribes to, or a malformed ID, is `404` `list.notFound`.

## Request body (`application/json`)

- `items` (array of object, required)
  - `kind` (string, required): One of "asset".
  - `id` (string (uuid), required)

## Responses

### 200

How many Assets were added and how many were already there.

- `data` (object, required)
  - `added` (integer, required)
  - `existing` (integer, 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`).

### 404

The resource does not exist or is not the user's.

### 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 (200)

```json
{
  "data": {
    "added": 0,
    "existing": 0
  }
}
```
