Monitors

Monitors run the same kind of search you can send to the content search endpoint, but the saved configuration is intentionally narrower. A monitor stores the standing query and filters. Omnist supplies the date window and result limit whenever the monitor runs.

Scheduled monitor runs use UTC content dates. Each scheduled run queues four dated jobs: the current UTC day and the trailing three UTC days. Each dated job uses an internal limit of 1000 results, writes into the monitor result store, and can be inspected through the monitor run APIs.

Create a Monitor

Create a monitor with a saved search and an hourly or daily schedule. Monitors cannot be reconfigured after creation. To stop a monitor permanently, delete it.

await fetch('https://api.omnist.ai/v1/monitors', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer omni_live_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'AI infrastructure',
    search: {
      query: 'AI infrastructure spending',
      media_types: ['news', 'wire'],
      include_domains: ['reuters.com', 'ft.com']
    },
    schedule: {
      frequency: 'daily',
      timezone: 'America/New_York',
      run_time: '07:30'
    }
  })
});

import requests

requests.post(
    'https://api.omnist.ai/v1/monitors',
    headers={
        'Authorization': 'Bearer omni_live_...',
        'Content-Type': 'application/json',
    },
    json={
        'name': 'AI infrastructure',
        'search': {
            'query': 'AI infrastructure spending',
            'media_types': ['news', 'wire'],
            'include_domains': ['reuters.com', 'ft.com'],
        },
        'schedule': {
            'frequency': 'daily',
            'timezone': 'America/New_York',
            'run_time': '07:30',
        },
    },
)

Request Body

Monitor Search

Monitors do not accept start_date, end_date, or limit. Date windows are computed at run time and each run uses an internal limit of 1000.

Schedule

Response

{
  "id": "mon_01h...",
  "team_id": "team_01h...",
  "name": "AI infrastructure",
  "description": null,
  "status": "active",
  "search": {
    "query": "AI infrastructure spending",
    "media_types": ["news", "wire"],
    "include_domains": ["reuters.com", "ft.com"]
  },
  "schedule": {
    "frequency": "daily",
    "timezone": "America/New_York",
    "run_time": "07:30"
  },
  "next_run_at": "2026-05-13T11:30:00Z",
  "created_at": "2026-05-12T18:08:23Z",
  "updated_at": "2026-05-12T18:08:23Z"
}

List Monitors

Returns active and disabled monitors for the workspace.

Get a Monitor

Returns the saved search, schedule, status, and next scheduled run time for a monitor.

Update a Monitor

Updates the monitor name or schedule. The saved search cannot be changed after creation.

{
  "name": "AI infrastructure",
  "schedule": {
    "frequency": "daily",
    "timezone": "America/New_York",
    "run_time": "07:30"
  }
}

Delete a Monitor

Permanently disables the monitor. The monitor will not be scheduled again.

Run a Monitor Now

Queues the same work as a scheduled run: UTC today and the trailing three UTC days. The response includes a parent task ID. Use the backfill status endpoint to inspect the child dated jobs.

{
  "task_id": "2e4efb9a-5e88-4658-9c5f-8e3ec3d56a0e",
  "status": "queued",
  "queued": [
    {
      "published_date": "2026-05-12",
      "run_id": "7d7c0c5f-7f40-4f7a-a93d-09499e4d8e29",
      "task_id": "7d7c0c5f-7f40-4f7a-a93d-09499e4d8e29",
      "already_complete": false,
      "latest_indexed_content": null
    }
  ],
  "summary": {
    "requested": 4,
    "queued": 4,
    "already_complete": 0,
    "already_running": 0,
    "failed": 0
  }
}

Backfill Monitor Dates

Queues dated monitor runs for specific UTC published dates. You can submit up to 100 dates in one request.

By default, Omnist skips a date when that date already has a completed backfill whose run date was more than 72 hours after the published date. This keeps ordinary backfills from spending work on days that are already stable.

await fetch('https://api.omnist.ai/v1/monitors/mon_01h.../backfills', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer omni_live_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dates: ['2026-05-09', '2026-05-10', '2026-05-11'],
    skip_complete: true
  })
});

import requests

requests.post(
    'https://api.omnist.ai/v1/monitors/mon_01h.../backfills',
    headers={
        'Authorization': 'Bearer omni_live_...',
        'Content-Type': 'application/json',
    },
    json={
        'dates': ['2026-05-09', '2026-05-10', '2026-05-11'],
        'skip_complete': True,
    },
)

Request Body

Response

{
  "task_id": "be8c49a7-89ab-46b4-8a89-9f44442ceca9",
  "status": "queued",
  "queued": [
    {
      "published_date": "2026-05-10",
      "run_id": "75ca688d-8879-4a92-909d-fbd95720dc43",
      "task_id": "75ca688d-8879-4a92-909d-fbd95720dc43",
      "already_complete": false,
      "latest_indexed_content": "2026-05-11T03:12:22Z"
    }
  ],
  "skipped": [
    {
      "published_date": "2026-05-09",
      "already_complete": true,
      "latest_indexed_content": "2026-05-10T05:41:09Z"
    }
  ],
  "summary": {
    "requested": 3,
    "queued": 2,
    "already_complete": 1,
    "already_running": 0,
    "failed": 0
  }
}

latest_indexed_content is the high-water mark used for that date. It refers to the most recent enrichment completion timestamp already recorded in the monitor results for that published date.

List Backfill Status

Returns the per-date backfill ledger for a monitor.

{
  "monitor_id": "mon_01h...",
  "backfills": [
    {
      "date": "2026-05-10",
      "status": "succeeded",
      "run_id": "75ca688d-8879-4a92-909d-fbd95720dc43",
      "backfill_run_at": "2026-05-11T04:00:12Z",
      "backfill_run_date": "2026-05-11",
      "latest_indexed_content_at": "2026-05-11T03:12:22Z",
      "result_count": 18,
      "error_message": null
    }
  ],
  "summary": {
    "total": 3,
    "running": 0,
    "succeeded": 2,
    "failed": 0,
    "skipped": 1
  },
  "limit": 50,
  "offset": 0,
  "next_offset": null,
  "has_more": false
}

Get Backfill Task Status

Returns the parent task and its child dated jobs.

{
  "task_id": "be8c49a7-89ab-46b4-8a89-9f44442ceca9",
  "status": "running",
  "summary": {
    "requested": 3,
    "queued": 0,
    "running": 1,
    "succeeded": 1,
    "failed": 0,
    "skipped": 1
  },
  "tasks": [
    {
      "published_date": "2026-05-10",
      "run_id": "75ca688d-8879-4a92-909d-fbd95720dc43",
      "task_id": "75ca688d-8879-4a92-909d-fbd95720dc43",
      "status": "running",
      "latest_indexed_content": "2026-05-11T03:12:22Z"
    }
  ]
}

List Monitor Runs

Returns scheduled, manual, parent, and dated backfill runs.

List Monitor Results

Returns content items captured by the monitor.

Search Monitor Results

Searches within the monitor result store. It accepts the same request shape as content search, including the same date behavior and maximum limit of 100.