Add items to list
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_bodyAPI Reference
Add items to list
Append one or more items to a specific data list by UUID with primaryValue, searchKeys, and optional itemData payload β POST /data-lists//items.
POST
/
data-lists
/
{id}
/
items
Add items to list
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_bodyOverview
Adds one or more items to a specific list identified by UUID. Requires permission to update the list.Endpoint
POST https://api.gu1.ai/data-lists/{id}/items
Authentication
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Request Body
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)
Notes
- 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.
Response
201 with counts (processed, errors, duplicates, etc.) on success.Was this page helpful?