---
title: "Manage Signal Awareness"
method: POST
path: "/functions/v1/api/v2/signal-awareness"
tags: ["Signal Awareness"]
---

# Manage Signal Awareness

`POST /functions/v1/api/v2/signal-awareness`

## Request

- Base URL: `https://api.signaliz.com`
- URL: `https://api.signaliz.com/functions/v1/api/v2/signal-awareness`
- Auth: HTTP bearer

Create, list, update, run, pause, resume, delete, export, and configure durable Signal Awareness monitors.

## Request body

- SignalAwarenessLifecycleRequest: Full Signal Awareness monitor lifecycle request used by the SDK, CLI, and MCP.
  - `action` 'create' | 'list' | 'update' | 'delete' | 'manual_run' | 'list_signals' | 'bulk_import' | 'get_settings' | 'set_global_webhook' | 'test_webhook' | 'export' | 'send_signal_export', required
  - `monitor_id` string
  - `monitor` SignalAwarenessMonitorInput: A company to monitor. Signal sourcing uses the fixed Company Signal Enrichment evidence engine.
    - `company_name` string: Optional display name. Defaults to domain.
    - `domain` string, required
    - `schedule_cron` string: UTC five-field cron. Supports hourly intervals, daily, day intervals, weekly, and monthly days 1-28.
    - `webhook_url` string, uri, nullable
  - `monitors` SignalAwarenessMonitorInput[]
    - `company_name` string: Optional display name. Defaults to domain.
    - `domain` string, required
    - `schedule_cron` string: UTC five-field cron. Supports hourly intervals, daily, day intervals, weekly, and monthly days 1-28.
    - `webhook_url` string, uri, nullable
  - `defaults` SignalAwarenessMonitorDefaults: Schedule and delivery defaults applied to every bulk-imported company.
    - `schedule_cron` string
    - `webhook_url` string, uri, nullable
  - `updates` SignalAwarenessMonitorUpdate: Editable monitor fields. The company domain and signal acquisition policy are immutable.
    - `company_name` string
    - `schedule_cron` string: UTC five-field cron. Supports hourly intervals, daily, day intervals, weekly, and monthly days 1-28.
    - `status` 'active' | 'paused'
    - `webhook_url` string, uri, nullable
  - `enabled` boolean
  - `webhook_url` string, uri, nullable
  - `signal_ids` string[]
  - `signals` SignalAwarenessSignal[]
    - `signal_type` string, required
    - `signal_title` string, required
    - `signal_summary` string, required
    - `source` string, uri, required: Verified source URL supporting the signal.
    - `date` string, date, required
    - `company_name` string, required
    - `domain` string, required
  - `limit` integer
  - `offset` integer
  - `idempotency_key` string
  - `dry_run` boolean

## Response `200`

Signal Awareness response for the requested company domain.

- SignalAwarenessResult
  - `success` boolean
  - `data` object
    - `monitors` SignalAwarenessMonitor[]
      - `id` string
      - `company_name` string
      - `domain` string
      - `status` 'active' | 'paused'
      - `schedule` string
      - `schedule_cron` string
      - `webhook_url` string, uri, nullable
      - `total_runs` integer
      - `total_signals_found` integer
      - `consecutive_failures` integer
      - `auto_paused` boolean
      - `auto_pause_reason` string
      - `last_run_at` string, date-time
      - `next_run_at` string, date-time
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `monitor` SignalAwarenessMonitor
      - `id` string
      - `company_name` string
      - `domain` string
      - `status` 'active' | 'paused'
      - `schedule` string
      - `schedule_cron` string
      - `webhook_url` string, uri, nullable
      - `total_runs` integer
      - `total_signals_found` integer
      - `consecutive_failures` integer
      - `auto_paused` boolean
      - `auto_pause_reason` string
      - `last_run_at` string, date-time
      - `next_run_at` string, date-time
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `run` SignalAwarenessRun
      - `id` string
      - `monitor_id` string
      - `status` string
      - `signals_found` integer
      - `started_at` string, date-time
      - `completed_at` string, date-time
      - `created_at` string, date-time
    - `signals` SignalAwarenessSignal[]
      - `signal_type` string, required
      - `signal_title` string, required
      - `signal_summary` string, required
      - `source` string, uri, required: Verified source URL supporting the signal.
      - `date` string, date, required
      - `company_name` string, required
      - `domain` string, required
    - `signal_count` integer
    - `monitor_id` string
    - `run_id` string
    - `total` integer
    - `created` integer
    - `skipped` integer
    - `delivered` integer
    - `errors` object[]
      - `row` integer, required
      - `error` string, required
    - `output_mode` 'csv' | 'webhook'
    - `webhook_url` string, uri, nullable
    - `webhook_status` integer
    - `idempotent_replay` boolean
    - `status` string
    - `credits_used` integer
    - `credits_charged` integer
    - `cache_hit` boolean
    - `live_provider_called` boolean
    - `result_returned_from` 'stored_monitor_signals' | 'available_data' | 'fresh_signal_enrichment' | 'negative_cache'
  - `dry_run` boolean
  - `estimated_credits` object

## Other responses

- `400`: Invalid domain or schedule.
- `403`: AUTH_002: changes and runs require a write-capable or spend:credits scope.
- `404`: The company domain is not currently monitored.
- `409`: The company domain is already monitored.
- `429`: Rate limited. Retry after the indicated delay.

---

[API](https://skmtc.dev/signaliz/apis/signaliz-api.md) · [All operations](https://skmtc.dev/signaliz/apis/signaliz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signaliz/apis/signaliz-api/revisions/53cb64feddad?raw)