SendIt icon

SendIt

Multi-platform social media publishing with AI content generation

Listening → List Alerts

AI-generated

Summary

Retrieve a list of listening alerts with optional filters for team scope, unread status, alert priority, and maximum number of alerts to return.

Inputs

  • Team ID — Optional string to specify a team scope; sent as an X-Team-ID header if provided.
  • Idempotency Key — Optional string sent as Idempotency-Key header to ensure idempotency.
  • Alerts Unread Only — Boolean flag to filter the returned alerts to only those that are unread.
  • Alert Priority — Filter to specify the priority of alerts to return; options include Any, Critical, High, Medium, or Low.
  • Listening Limit — Maximum number of alert records to return; defaults to 50.

Output shape

a list of alert objects

The response returns a list of alerts filtered by the provided parameters. If optional headers like Team ID and Idempotency Key are set, they affect the request headers. Pagination beyond the specified limit is not detailed here.

Links

Discussion