Menu

Referência da API · Alertas

Destinatários

alerts · recipients · 1 operação

GET/v1/alerts/recipients

List who can receive an alert

alerts.recipients.list

LeituraIdempotenteDesde 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.

Escopo
alerts:read
Permissão
Ver o módulo
Tool do MCP
alerts_recipients_listNa superfície completa; na compacta, mb_execute_operation com id: "alerts.recipients.list".

Custo declarado: até 60 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

target_org_idstringqueryopcional

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

Resposta

dataarray<object>

Everyone who can receive the alert.

Erros

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

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