AI ArkDonnées de personnesEnrichment

Create or update an exclusion list

aiark.lists.upsert

Create, append to or replace a temporary list of people or company ids.

Prix: freeAu prix catalogue
Taux de réussite: —Aucune donnée de taux de réussite pour le momentAucune donnée de taux de réussite pour le moment
Latence p50: ——
Dernière vérification: 17 sept. 2026Vérifié et opérationnel

POSThttps://toolswitch.dev/v1/tools/aiark.lists.upsertBeta

Essayer en ligneDoc du fournisseur ↗

Utilise le quota de la plateforme
Réponse synchrone
Lit des données publiques

Paramètres

Lists expire after 24 hours. An account can keep up to 50 lists per day.

Paramètre	Type	Obligatoire	Description	Exemple
Corps (JSON)
`id`	chaîne	Facultatif	Existing list id. Omit to create a list.
`mode`	chaîne	Facultatif
`type`	chaîne	Facultatif	Required when creating a list.	`people_id`
`values`	array[string]	Obligatoire		`["00000000-0000-0000-0000-000000000000"]`

Corps (JSON)
idchaîneFacultatif
Existing list id. Omit to create a list.
modechaîneFacultatif
typechaîneFacultatif
Required when creating a list.
Exemple : people_id
valuesarray[string]Obligatoire
Exemple : ["00000000-0000-0000-0000-000000000000"]

Exemple de réponse

JSON

{
  "id": "sanitized-list-id",
  "type": "people_id",
  "values": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "created": true,
  "workspace": "sanitized-workspace"
}

Exemples de code

Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.

Beta

curl -X POST 'https://toolswitch.dev/v1/tools/aiark.lists.upsert' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"type":"people_id","values":["00000000-0000-0000-0000-000000000000"]}'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/aiark.lists.upsert",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("{\"type\":\"people_id\",\"values\":[\"00000000-0000-0000-0000-000000000000\"]}"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/aiark.lists.upsert", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("{\"type\":\"people_id\",\"values\":[\"00000000-0000-0000-0000-000000000000\"]}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Cette API de passerelle est en version Beta ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à free, frais de service inclus.