Agregar ítems a una lista
curl --request POST \
--url http://api.gu1.ai/data-lists/{id}/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{}
],
"options": {}
}
'import requests
url = "http://api.gu1.ai/data-lists/{id}/items"
payload = {
"items": [{}],
"options": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({items: [{}], options: {}})
};
fetch('http://api.gu1.ai/data-lists/{id}/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/data-lists/{id}/items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
]
],
'options' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/data-lists/{id}/items"
payload := strings.NewReader("{\n \"items\": [\n {}\n ],\n \"options\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://api.gu1.ai/data-lists/{id}/items")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {}\n ],\n \"options\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/data-lists/{id}/items")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {}\n ],\n \"options\": {}\n}"
response = http.request(request)
puts response.read_bodyReferencia API
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//items.
POST
/
data-lists
/
{id}
/
items
Agregar ítems a una lista
curl --request POST \
--url http://api.gu1.ai/data-lists/{id}/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{}
],
"options": {}
}
'import requests
url = "http://api.gu1.ai/data-lists/{id}/items"
payload = {
"items": [{}],
"options": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({items: [{}], options: {}})
};
fetch('http://api.gu1.ai/data-lists/{id}/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/data-lists/{id}/items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
]
],
'options' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/data-lists/{id}/items"
payload := strings.NewReader("{\n \"items\": [\n {}\n ],\n \"options\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://api.gu1.ai/data-lists/{id}/items")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {}\n ],\n \"options\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/data-lists/{id}/items")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {}\n ],\n \"options\": {}\n}"
response = http.request(request)
puts response.read_bodyResumen
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
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cuerpo de la solicitud
array
required
Each element:
primaryValue(string, required)searchKeys(string[], optional)category(string, optional)riskScore(number, optional)itemData(object, optional)metadata(object, optional)
object
batchSize(number, optional)ignoreDuplicates(boolean, optional)updateExisting(boolean, optional)
Notas
- For large uploads with richer per-row fields, prefer Bulk import items (
POST /data-lists/{id}/items/bulk). - Shortcut
POST /data-lists/{type}/itemsadds 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.Was this page helpful?