> ## 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.

# Agregar ítems por tipo (atajo)

> Atajo legacy para agregar ítems a la primera lista activa del tipo indicado; usa POST /data-lists/{id}/items si tienes múltiples listas del mismo tipo.

## Resumen

Agrega ítems a la **primera lista activa** del `{type}` (orden por `createdAt` en la implementación). Si **no** hay lista activa, responde `404` con indicación de crear una con `POST /data-lists`.

Con **varias** listas por tipo, usá siempre **[Agregar ítems](/es/api-reference/data-lists/add-items)** con UUID explícito.

## Endpoint

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

## Autenticación

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

## Cuerpo de la solicitud

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

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

## Respuesta

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