Skip to main content

Updates the mail group information

PATCH/v2/groups/:id_or_email

Updates the mail group information by mail group ID or email address. Read-only and immutable fields are not modified.

Request​

Path parameters

    id_or_email stringrequired
    • id:
    • email:

Body parameters

    name string

    Group name.

    status enum

    Status. Only the domain administrator or authorized applications can modify it.

    • NORMAL: Normal
    • FREEZE: Frozen

    Possible values: [NORMAL, FREEZE]

    admins string[]

    Administrator. Can only be modified by an administrator or an authorized application. (Optional field: returned when you add the $select=admins query parameter to the URL. To query multiple fields, separate them with commas.)

    needMessageDeliveryReview boolean

    Indicates whether message delivery review is required. This field is accessible only to administrators or authorized applications and can be modified. (Optional field: It is returned when the $select=needMessageDeliveryReview query parameter is added to the URL. For multiple fields, use commas to separate them.)

    messageDeliveryReviewers string[]

    Message delivery reviewer, accessible and modifiable only by administrators or authorized applications. (Optional field: returned when the query parameter $select=messageDeliveryReviewers is added to the URL. Separate multiple fields with commas.)

    allowedSenders string[]

    The persons allowed to send messages to this group. Only accessible and modifiable by administrators or authorized applications. (Optional field: returns when the $select=allowedSenders query parameter is added to the URL. Use commas to separate multiple fields.)

    allowedSenderPolicy enum

    Specifies who can send messages to this group. Accessible and modifiable only by administrators or authorized applications. (Optional field: returned by adding the $select=allowedSenderPolicy query parameter in the URL. Use commas to separate multiple fields.)

    • ANYONE:
    • SAME_ORGANIZATION:
    • GROUP_MEMBER:
    • ONLY_ALLOWED_SENDER:
    • GROUP_MEMBER_AND_ALLOWED_SENDER:

    Possible values: [ANYONE, SAME_ORGANIZATION, GROUP_MEMBER, ONLY_ALLOWED_SENDER, GROUP_MEMBER_AND_ALLOWED_SENDER]

    dynamicMatchRule string

    Dynamic group member matching rules. Only accessible and modifiable by administrators or authorized applications. (Optional field: returns when the $select=dynamicMatchRule query parameter is added to the URL. For multiple fields, use English commas to separate them.)

    itemCountLimit number<int32>

    Maximum member limit, up to 100000. Only the administrator or authorized applications can modify it (Optional field: returned after adding the $select=itemCountLimit query parameter in the URL. For multiple fields, separate them with commas).

    departmentId string

    Department of the user (optional field: returned when the $select=departmentId query parameter is added to the URL; separate multiple fields with commas).

    isHidden boolean

    Whether to display this group in the address book. Only administrators or authorized applications can access it; can be modified. (Optional field: returned when the $select=isHidden query parameter is added to the URL; separate multiple fields with commas.)

    ignoreAutoReplyOfMember boolean

    Ignores the auto-reply of members. Accessible and modifiable only by administrators or authorized applications. (Optional field: returned by adding the $select=ignoreAutoReplyOfMember query parameter in the URL. Use commas to separate multiple fields.)

    sendMessageToNewMember boolean

    Indicates whether to send a notification letter to newly added members. Accessible only by administrators or authorized applications, modifiable. (Optional field: Returned by adding the $select=sendMessageToNewMember query parameter in the URL. Separate multiple fields with commas.)

    requireApprovalWhenMemberLeaves boolean

    Whether administrator approval is required when a member leaves. Only accessible by domain administrators or authorized applications. Modifiable. (Optional field: returned when the $select=requireApprovalWhenMemberLeaves query parameter is added to the URL. Use English commas to separate multiple fields.)

    memberOnlyVisibleToAdmin boolean

    Whether the member is visible only to the administrator. Only the domain administrator or an authorized application can modify it (Optional field: returned after adding the $select=memberOnlyVisibleToAdmin query parameter in the URL. Use commas to separate multiple fields).

Response

No response fieldsA successful response contains no documented fields.

Errors

400Bad Request
401

Access is unauthorized. Please check whether the correct authorization token is passed.

403

No API access permission. Please complete the relevant authorization on the application management page of the domain administrator.

404Not Found