---
title: "List notification recipients for admin"
method: POST
path: "/admin/v1alpha1/notification-recipients"
tags: ["AdminRead"]
---

# List notification recipients for admin

`POST /admin/v1alpha1/notification-recipients`

## Request

- Base URL: `https://localhost:2333`
- URL: `https://localhost:2333/admin/v1alpha1/notification-recipients`
- Auth: none declared

Resolve workspace namespaces to notify-compatible email or phone recipients. Notification methods default to email.

## Request body

- HelperAdminNotificationRecipientsReq
  - `namespaces` string[], required
  - `notificationMethods` string[]

## Response `200`

successful notification recipient lookup

- HelperAdminNotificationRecipientsResp
  - `recipients` HelperAdminNotificationRecipient[]
    - `type` string
    - `value` string
  - `unresolvedNamespaces` string[]
  - `users` HelperAdminNotificationUser[]
    - `namespace` string
    - `notificationContacts` HelperAdminNotificationContacts
      - `emails` string[]
      - `phoneNumbers` string[]
    - `oauthProviders` HelperAdminNotificationContacts
      - `emails` string[]
      - `phoneNumbers` string[]
    - `userUid` string, uuid
  - `namespacesWithoutRecipients` string[]

## Other responses

- `400`: invalid notification recipient request
- `401`: authentication failed
- `500`: internal server error

## Changes

- **2026-09-02** `acd38d9540d3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/labring/apis/sealos-account-service/changes/admin/v1alpha1/notification-recipients/post.md)

---

[API](https://skmtc.dev/labring/apis/sealos-account-service.md) - [All operations](https://skmtc.dev/labring/apis/sealos-account-service/llms.txt) - [OpenAPI document](https://skmtc.dev/labring/apis/sealos-account-service/revisions/acd38d9540d3?raw)