Skip to main content
POST
/
data-lists
Criar lista de dados
curl --request POST \
  --url http://api.gu1.ai/data-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "description": "<string>",
  "source": "<string>",
  "config": {},
  "fieldMappings": {},
  "priority": 123,
  "isGlobal": true
}
'

​
Visão geral

Cria uma nova data list para a organização. Use type: "custom" para uma lista genérica referenciada por UUID nas regras.

​
Endpoint

POST https://api.gu1.ai/data-lists

​
Autenticação

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Corpo da solicitação

​
name
string
required
Nome de exibição (1–200 caracteres). Aparece no dashboard (catálogo, seletores, cabeçalhos) para identificar a lista; não altera como as regras avaliam itens.
​
type
string
required
List type enum, including custom, company_blocklist, document_blocklist, keyword_list, ip_blocklist, and others supported by the platform.
​
description
string
Descrição opcional (máx. 1000 caracteres). Use como contexto interno (responsável, política de atualização, caso de uso); visível onde o produto mostra o detalhe da lista. Não é usada pelo motor de correspondência.
​
source
string
required
Origin of data, e.g. manual_entry, api_integration, custom_upload, internal, etc.
​
config
object
Optional: autoSync, syncFrequency, externalUrl, apiKey, visibleItemDataColumns, etc.
​
fieldMappings
object
Optional string-to-string map for ingestion mappings.
​
priority
number
default:"50"
Priority 1–100.
​
isGlobal
boolean
Reserved for platform use; tenant clients normally omit or set false.

​
Example

{
  "name": "High-risk merchants",
  "description": "Internal blocklist for KYB rules",
  "type": "custom",
  "source": "api_integration"
}

​
Resposta

201 with success, data (includes list id), and timing metadata on success.