Group Announcement API

The calls to the /api/group_announcement API endpoint allow to view, add, and delete Group's edit access to announcements.

Prerequisites:

Table of contents:

  1. Access Admin > System > API Toolkit
  2. Get Group's Announcement Edit Access
  3. Add Announcement Edit Access to Group
  4. Delete Group's Announcement Edit Access

1. Access Admin > System > API Toolkit

2. Get Group's Announcement Edit Access

  1. Item: group_announcement
  2. Methods: GET
  3. Optionally, provide values for the following parameters to filter out the returned data:
    • ID: The ID of the Group/Announcement pair (see Fields Description for details)
    • group: The ID of the Group
  4. Enter an API Token
  5. [Run request]
  6. The returned object contains an array of objects each of which contains information about a Group's access to an Announcement
Example Response
{
    "group_announcements": [
        {
            "id": "1",
            "group": "53",
            "announcement": "22",
            "edit_access": "Y"
        },
        {
            "id": "2",
            "group": "53",
            "announcement": "33",
            "edit_access": "Y"
        },
        {
            "id": "3",
            "group": "60",
            "announcement": "10",
            "edit_access": "Y"
        }
    ]
}

Fields Description

Field Name Value Type Description
id string The ID of the object representing a single Group/Announcement pair.
group string The ID of the Group.
announcement string The ID of the Announcement.
edit_access string Whether or not the Group has edit access to the Announcement.

3. Add Announcement Edit Access to Group

  1. Item: group_announcement
  2. Methods: POST
  3. Enter an ID of the existing Group/Announcement pair
  4. Select JSON request and provide the corresponding values for the following parameters:
    • announcement: The ID of the Announcement
    • group: The ID of the Group
  5. Enter an API Token
  6. [Run request]
  7. The returned object contains an object with information about a Group's edit access to an Announcement

4. Delete Group's Announcement Edit Access

  1. Item: group_announcement
  2. Methods: DELETE
  3. Enter an ID of the existing Group/Announcement pair that needs to be deleted
  4. Enter an API Token
  5. [Run request]