Delete multiple members from a group

This PUT operation removes group members in bulk (multiple) from a specific group by passing first the group’s ID into the URL. If successful, you receive an HTTP response code of 204.

The operation is atomic. Either all supplied members are deleted or none.

PUT /sqs/api/groups/<id>/members/_bulk/delete

HEADER INFO

authorisation: HTTP Basic Auth

tenant: <tenantName>

permissions: SQS_GROUP_DELETE_PERMISSION

URL parameters

Parameter Description

id

The auto-assigned identifier that was given to the group upon creation.


JSON request payload

In the JSON payload, specify (in an array) the group members you wish to remove from the group.

Subscribers specified in the list who aren’t group members are ignored. 
{
  "members" : ["12345", "23456"]
}

SQS members data type descriptions

Field Type Description

memberId

string

The unique ID for the member. This is typically the MSISDN of the subscriber.

The subscriber’s MSISDN in international format.

quota

integer

The quota amount shared with the specified group member. This can be an exact amount or most often, a percentage of the donor plan.

Quota can be volume of data, time, or credit. This is all determined by the unitMeteringType in the donor plan definition.
See the Share Quota operation for a better understanding of sharing percentage or exact amount (bytes).

HTTP response codes

Code Description

200

success!

207

Multistatus response

Check out HTTP statuses for more details.
This is not applicable to all operations.

400

malformed request

401

unauthorised; bad username or password

403

forbidden; user does not have appropriate privileges

404

group member not found

409

conflict with target resource

This often occurs if the item already exists, such as a plan, group, or name.
This is not applicable to all operations.

412

failed validation; this typically means that a property was not set or a value is out of range.

example
HTTP 412
{
  "errors" : [
        {
          "field" : "name",
          "description" : "name is mandatory"
        }
    ]
}

422

failed processing (after passing validation).

example
HTTP 422
{
    "message": "Subscriber max plan count exceeded",
    "errorCode": 1
}
Example 1. SQS response codes

  • 0 = no error

  • 1 = undefined general error

  • 2 = group owner/name pair is not unique

  • 3 = group owner cannot be a member

  • 4 = total member quota exceeds 100%

  • 5 = group does not exist

  • 6 = maximum group size exceeded

  • 7 = the donor does not exist

  • 8 = the shareable plan does not exist

  • 9 = the shareable plan is not a recurring plan

  • 10 = charging group owner unsupported

  • 11 = the recurring donation for this plan already exists

  • 12 = the recipient does not exist

  • 13 = the donor plan max recipient limit was exceeded

  • 14 = subscriber not found

  • 15 = quota is unavailable

  • 16 = donor plan is not shareable

500

internal error

503

request rejected due to overload