Update reader group
  • 06 Jul 2021
  • 1 Minute to read
  • Contributors
  • Dark
    Light

Update reader group

  • Dark
    Light

PUT/readers/groups

Update a reader group to the project.


Parameter Type Description
api_token string REST API key you can obtain from Settings > Advanced > API tokens.

Body Parameters

Parameters highlighted in bold are mandatory

Parameter Type Description
reader_group_id string The ID of the reader group.
title string The name of the reader group.
description string Description of the reader group.
associated_readers string[] List of reader IDs to be associated with this reader group.
access_scope object Access scope of this reader group.

Body Parameters > access_scope

Parameter Type Description
access_level number The access level for the reader group. 1-Category, 2-Version, 3-Project.
categories string[] List of category IDs the reader group has access to. Mandatory when access_level is 1-Category.
project_versions string[] List of project version IDs the reader group has access to. Mandatory when access_level is 2-Version.

Sample Request

Giving access to specific project versions.

{
  "title": "Students",
  "description": "Reader group for students",
  "associated_readers": [
    "9951f2e4-4fe3-47b9-b099-1aab99e1de76",
    "d7c9a42c-a1c8-40ed-bcaa-02110227b758"
  ],
  "access_scope": {
    "access_level": 2,
    "project_versions": [
      "a928fc89-66d5-4a0c-b962-8fcb1db4dbd6",
      "a507ffa2-25a4-468a-a51a-a2d1644046ae"
    ]    
  }
}

Sample Response

{
  "extension_data": null,
  "context": null,
  "success": true,
  "errors": [],
  "warnings": [],
  "information": []
}

Was this article helpful?