> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add items by list type (legacy shortcut)

> POST /data-lists/{type}/items — appends to the first active list of that type; prefer POST /data-lists/{id}/items when you have multiple lists.

## Overview

Adds items to the **first active list** returned for `{type}` (ordered by `createdAt` descending with `limit: 1` in the implementation). If **no** active list exists, returns `404` with a hint to create one via `POST /data-lists`.

For production integrations with **more than one** list per type, always use **[Add items](/en/api-reference/data-lists/add-items)** with the explicit list **UUID**.

## Endpoint

```
POST https://api.gu1.ai/data-lists/{type}/items
```

## Authentication

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Request Body

Same shape as **[Add items](/en/api-reference/data-lists/add-items)**:

* `items` (required): 1–1000 entries with `primaryValue`, optional `searchKeys`, `category`, `riskScore`, `itemData`, `metadata`.
* `options`: `batchSize`, `ignoreDuplicates`, `updateExisting`.

## Response

`201` with `listId` resolved by the server, plus ingest counters.