Adicionar itens à 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_bodyReferência API
Adicionar itens à lista
Adiciona um ou mais itens a uma lista específica pelo UUID, com primaryValue, searchKeys e itemData opcionais — POST /data-lists//items.
POST
/
data-lists
/
{id}
/
items
Adicionar itens à 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_bodyVisão geral
Adiciona um ou mais itens a uma lista identificada por UUID. Exige permissão de atualização na lista.Endpoint
POST https://api.gu1.ai/data-lists/{id}/items
Autenticação
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Corpo da solicitação
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.
Resposta
201 with counts (processed, errors, duplicates, etc.) on success.Was this page helpful?