Sign in
Alerts

List Alerts (GET alias for POST /list).

List alerts with pagination and filtering.

get/v1/alerts

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

Changed in 3 of the 29 revisions of this API.312

  • 5d4c905106b41See the full diff
    • ○

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API

      api-security-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 72cc17ba6f7f2See the full diff
    • ○

      added the new optional query request parameter after

      new-optional-request-parameter

    • ○

      added the new optional query request parameter next_cursor

      new-optional-request-parameter

  • 7cb05153331139See the full diff
    • ●

      added the new dlq_growth enum value to the results/items/system_condition/anyOf[subschema #1: SystemCondition]/type response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new provider_quota_exhausted enum value to the results/items/system_condition/anyOf[subschema #1: SystemCondition]/type response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new task_queue_degraded enum value to the results/items/system_condition/anyOf[subschema #1: SystemCondition]/type response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new geo_bounding_box enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_bounding_box enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_bounding_box enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_polygon enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_polygon enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_polygon enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_radius enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_radius enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    • ○

      added the new geo_radius enum value to the request property filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator

      request-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog