> ## 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 a una lista

> Agrega uno o varios ítems a una lista específica por UUID con primaryValue, searchKeys y itemData opcionales — POST /data-lists/{id}/items.

## Resumen

Agrega uno o más ítems a una lista identificada por **UUID**. Requiere permiso de actualización sobre la lista.

## Endpoint

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

## Autenticación

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

## Cuerpo de la solicitud

<ParamField body="items" type="array" required>
  Each element:

  * `primaryValue` (string, required)
  * `searchKeys` (string\[], optional)
  * `category` (string, optional)
  * `riskScore` (number, optional)
  * `itemData` (object, optional)
  * `metadata` (object, optional)
</ParamField>

<ParamField body="options" type="object">
  * `batchSize` (number, optional)
  * `ignoreDuplicates` (boolean, optional)
  * `updateExisting` (boolean, optional)
</ParamField>

## Notas

* For **large** uploads with richer per-row fields, prefer **[Bulk import items](/es/api-reference/data-lists/bulk-import-items)** (`POST /data-lists/{id}/items/bulk`).
* Shortcut **`POST /data-lists/{type}/items`** adds to the **first active list** of that type (oldest by default). Prefer **list id** when you have multiple lists per type.

## Respuesta

`201` with counts (`processed`, `errors`, `duplicates`, etc.) on success.