Resource: Group Permission Projects ( /api/group/{id}/permissions/projects )

Returns links to the set of project group permissions resources

Methods

GET

Retrieves a set of links, one for each project, which can be used to manage the project group permissions for this group.

Required Permissions

  • Administration/Organisation/ManageUserAndGroupSecurity

Status Codes

These are the expected status codes returned by the service - in addition, some other status codes may be returned if either an internal error occurs or there is an authentication issue (such as an expired OAuth token).

StatusDescription
200 - OKReturned if the request was completed successfully.
404 - NotFoundReturned if the group does not exist.

Example - Retrieve project permission links

Retrieve a set of links for managing this groups permissions associated with each project

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}3a31a68a-9e51-4d87-91bb-aca0fa5c1fe9Unique ID of the group to retrieve project permission links for

Response Headers

KeyValueDescription
Content-Typeapplication/json; charset=utf-8

Response Body

{
  "Projects": [
    {
      "ProjectId": "4feb1531-77eb-4393-918f-ed17bc5e12d7",
      "Self": "http://localhost/api/group/3a31a68a-9e51-4d87-91bb-aca0fa5c1fe9/permissions/project/4feb1531-77eb-4393-918f-ed17bc5e12d7",
      "Links": [
        {
          "Title": "Project X",
          "Href": "http://localhost/api/project/4feb1531-77eb-4393-918f-ed17bc5e12d7",
          "Rel": "Project"
        }
      ]
    },
    {
      "ProjectId": "e1a9644c-9d20-44a8-847f-eabff527cebc",
      "Self": "http://localhost/api/group/3a31a68a-9e51-4d87-91bb-aca0fa5c1fe9/permissions/project/e1a9644c-9d20-44a8-847f-eabff527cebc",
      "Links": [
        {
          "Title": "Project Y",
          "Href": "http://localhost/api/project/e1a9644c-9d20-44a8-847f-eabff527cebc",
          "Rel": "Project"
        }
      ]
    }
  ],
  "Self": "http://localhost/api/group/3a31a68a-9e51-4d87-91bb-aca0fa5c1fe9/permissions/projects"
}

Status Code

200 - OK

  • No labels