---
title: "Change company schedule"
method: POST
path: "/functions/v1/api/v2/signal-awareness/companies/schedule"
tags: ["Signal Awareness"]
---

# Change company schedule

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

## Request

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

Set a monitored company to a daily, weekly, or monthly schedule by domain.

## Request body

- SignalAwarenessChangeScheduleRequest: Change a monitored company schedule by domain.
  - `domain` string, required
  - `schedule` 'daily' | 'weekly' | 'monthly', required

## 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)