Remove groups from a series
Removes one or more Mindtickle groups from a Mindtickle series.
Prerequisites
- Authentication and setup: A valid access token.
- Invite groups to a series: The groups must be invited to the series.
Endpoint
Section titled “Endpoint”POST /services/data/v4.0/mtobjects/Series/SERIES_ID/Groups/deleteBase URL: the standard REST host for your region. See Base URLs.
Headers: Authorization: Bearer ACCESS_TOKEN, Content-Type: application/json.
Path parameters
Section titled “Path parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
SERIES_ID |
string | Required | Mindtickle ID of the series from which you want to remove groups. |
Request
Section titled “Request”| Parameter | Type | Required | Description |
|---|---|---|---|
groupIds |
Array[string] | Required | Mindtickle IDs of the groups that you want to remove from the series. Send each ID as a separate string in the JSON array. |
Request example
Section titled “Request example”{ "groupIds": ["1234567890123456101", "1234567890123456102", "1234567890123456103"]}Response
Section titled “Response”| Field | Type | Description |
|---|---|---|
processId |
string | Mindtickle process ID. Pass it as an item in the processIds array when checking process status. |
Response example
Section titled “Response example”{ "processId": "1234567890123456104"}- Async processing: The request is queued, and the response returns a process ID you use to check the result.
- Limits: You can remove a maximum of 20 groups per request.