Saltar al contenido principal
POST
Create threat detection config

Descripción general

Crea una nueva configuración de detección de amenazas para que una fuente empiece a escanear para tu organización. Las fuentes que están desactivadas de forma predeterminada no tienen una fila de configuración, así que no se pueden activar mediante Actualizar configuración de detección hasta que crees una aquí. Una misma fuente puede tener varias configuraciones, cada una con su propia consulta, programación o marca. Usa title y description para distinguirlas.

Cuándo usarlo

  • Activar una fuente que está desactivada de forma predeterminada para tu organización.
  • Agregar otra configuración a una fuente que ya ejecutas (por ejemplo, una segunda consulta o una variante limitada a una marca).
  • Aprovisionar de forma programática un payload config específico de la fuente.
Para una configuración existente, usa en su lugar Actualizar configuración de detección.

Cómo funciona

  • source debe ser una clave devuelta por Listar fuentes de detección. Se rechazan las fuentes que son solo globales y las fuentes sin implementación.
  • cron solo se acepta para fuentes programadas (basadas en pull). Omítelo para usar la programación predeterminada de la fuente.
  • config se valida contra el configSchema de la fuente que devuelve Listar fuentes de detección. Se permite un objeto vacío {}; los valores predeterminados del esquema se aplican al momento del escaneo.
  • brandId, cuando se envía, debe pertenecer a tu organización. Omítelo para una configuración que abarque toda la organización.
  • La configuración y una fila inicial de historial se escriben en una sola transacción para que los trabajos de sincronización de valores predeterminados (default-sync) no la desactiven.

Autorizaciones

X-API-KEY
string
header
requerido

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.

Cuerpo

application/json

Create a threat detection config

Creates the config row that makes a detection source run for your organization. Sources that are disabled by default have no config row, so they cannot be enabled through /detection/configs/update until one exists.

A source can have several configs, each scanning with its own query, schedule or brand. Use title to tell them apart.

source
enum<string>
requerido

Detection source key, from GET /detection/sources. The source must support the organization scope; global-only sources cannot be configured per organization.

Opciones disponibles:
meta_ads_search,
telegram_channels_search_vetric,
telegram_user_search_vetric,
facebook_page_search_vetric,
facebook_user_search_vetric,
facebook_post_search_vetric,
instagram_account_search_vetric,
twitter_search_vetric,
meta_ads_search_vetric,
tik_tok_user_search_vetric,
tik_tok_video_search_vetric,
blocklist,
apple_app_store,
google_ads_search,
google_ads_transparency_search,
mozilla_addon_search,
asset_check,
twitter_post_search,
medium_tag_rss,
twitter_search,
yahoo_search,
duck_duck_go_search,
bing_search,
guestbook,
certstream,
external,
google_search,
dns_twist,
twitter,
twitter_username_monitor,
urlscan,
urlscan_hostname_search,
youtube_search,
google_play_search,
blocked_ip_scan,
blocked_bilibili_suggested,
grok_post_search,
grok_user_search,
google_lens_image_search,
yandex_search,
yandex_image_search,
linkedin_employee_detection,
linkedin_post_search,
linkedin_company_search,
dnsdb,
daily_motion_search,
watchlist,
github_search,
pump_fun_token_search,
dnsdb_watched_parents,
ct_log_search,
spamhaus_passive_dns,
spamhaus_zrd_dbl,
ranger,
reddit_subreddit_search,
adlibrary_ads_search,
dexscreener_search,
tik_tok_user_search,
tik_tok_video_search,
tik_tok_ads_search,
linkedin_people_search_vetric,
linkedin_company_search_vetric,
bing_ads_search,
telegram_user_search,
telegram_channels_search
slug
string

Organization slug. Defaults to the organization your API key is scoped to, so you only need this when authenticating with a key that spans organizations.

Minimum string length: 1
status
enum<string>
predeterminado:ENABLED

Status to create the config with. Defaults to ENABLED.

Opciones disponibles:
ENABLED,
DEPRECATED_EVALUATE,
DISABLED
title
string

Optional label for this config

description
string | null

Optional human-readable description of what the config does

cron
string | null

Optional custom CRON schedule. Only accepted for sources that run on a schedule; the source's default schedule is used when omitted.

config
object

Source-specific configuration, validated against that source's configSchema from GET /detection/sources. When omitted the source's schema defaults are applied.

brandId
integer | null

Optional brand to scope this config to. The brand must belong to the same organization. Omit for an organization-wide config.

Rango requerido: x > 0

Respuesta

Successful response

Created detection config

config
object
requerido