Menú

Referencia de la API · Alertas

Destinatarios

alerts · recipients · 1 operación

GET/v1/alerts/recipients

List who can receive an alert

alerts.recipients.list

LecturaIdempotenteDesde 2026-11-01

Lists the members who can receive an alert that watches the workspace itself or one of its Accounts (target_org_id, default the workspace): for an Account, the workspace's owners and admins, the Account's own members and the workspace members assigned to it; for the workspace, all its members. Members without a valid email are left out. Returns user_id, display_name (null when the member has no name), email, role and photo_url; pass the user_ids as recipients to alerts.alerts.create or alerts.alerts.update. Not paginated. 400 invalid_target when the organization is not this workspace or one of its Accounts the credential reaches.

Alcance
alerts:read
Permiso
Ver el módulo
Tool del MCP
alerts_recipients_listEn la superficie completa; en la compacta, mb_execute_operation con id: "alerts.recipients.list".

Costo declarado: hasta 60 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

target_org_idstringqueryopcional

The watched organization: the workspace (default) or one of its Accounts.

Respuesta

dataarray<object>

Everyone who can receive the alert.

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/alerts/recipients" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/alerts/recipients" \
  -H "Authorization: Bearer $MB_TEST_KEY"