Alerts

List Alerts

Changed on

List all alerts in the namespace with optional filtering and pagination.

**Filtering:**
- Use `search` for wildcard text search across alert_id, name, description
- Use `filters` for structured queries

**Sorting:**
- Default: created_at descending (newest first)
post/v1/alerts/list

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/alerts/list
  • Auth: HTTP bearer and API key in header X-Namespace

Query parameters

limitinteger nullable
page_sizeinteger nullable
offsetinteger nullable
pageinteger nullable
cursorstring nullable
next_cursorstring nullable
afterstring nullable
include_totalboolean

Request body

searchstring nullable

Search term for wildcard search across alert_id, name, description

case_sensitiveboolean

If True, filters and search will be case-sensitive

Example request

{
  "filters": {
    "AND": [
      {
        "field": "name",
        "operator": "eq",
        "value": "John"
      },
      {
        "field": "age",
        "operator": "gte",
        "value": 30
      }
    ],
    "OR": [
      {
        "field": "status",
        "operator": "eq",
        "value": "active"
      },
      {
        "field": "role",
        "operator": "eq",
        "value": "admin"
      }
    ],
    "NOT": [
      {
        "field": "department",
        "operator": "eq",
        "value": "HR"
      },
      {
        "field": "location",
        "operator": "eq",
        "value": "remote"
      }
    ],
    "case_sensitive": true
  },
  "sort": {
    "field": "created_at"
  }
}

Response

Successful Response

total_countinteger required

Total number of alerts matching query

Example response

{
  "results": [
    {
      "alert_id": "alt_safety_001",
      "description": "Alerts when new videos match known safety incidents",
      "enabled": true,
      "name": "Safety Incident Detector",
      "notification_config": {
        "channels": [
          {
            "channel_id": "wh_safety_team",
            "channel_type": "webhook"
          }
        ],
        "include_matches": true,
        "include_scores": true
      },
      "retriever_id": "ret_safety_search"
    }
  ]
}

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      added the new ingest_stalled enum value to the //// response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • b75474e978ffRevision changes
    • warning

      added the new budget_threshold enum value to the //// response property for the response status

    • warning

      added the new collection_stale enum value to the //// response property for the response status

    • warning

      added the new retriever_no_interactions enum value to the //// response property for the response status