Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Example - Get All Groups

An example of fetching all groups.

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}8E064E7A-847F-4853-AFFF-2CD1803664D7The ID of the user to fetch group membership for

Response Headers

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

Response Body

Code Block
languagenone
[
  {
    "Id": "9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44",
    "Name": "Admins",
    "Description": "System Administrators",
    "Self": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44",
    "Links": [
      {
        "Title": "Members",
        "Href": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44/users",
        "Rel": "Users"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44/permissions/projects",
        "Rel": "ProjectPermissions"
      }
    ]
  },
  {
    "Id": "9e1ee34b-f96f-4005-9f7a-1457df86256d",
    "Name": "QA",
    "Description": "QA Team (Testers + Test Managers)",
    "Self": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d",
    "Links": [
      {
        "Title": "Members",
        "Href": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d/users",
        "Rel": "Users"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d/permissions/projects",
        "Rel": "ProjectPermissions"
      }
    ]
  }
]

Status Code

200 - OK

...

Example - Set Members

Set the groups a user belongs to.

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}8E064E7A-847F-4853-AFFF-2CD1803664D7The ID of the user to set groups for.

Request Body

Code Block
languagenone
{
  "Items": [
    {
      "Id": "9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44"
    },
    {
      "Id": "9e1ee34b-f96f-4005-9f7a-1457df86256d"
    }
  ]
}

Response Headers

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

Response Body

Code Block
languagenone
[
  {
    "Id": "9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44",
    "Name": "Admins",
    "Description": "System Administrators",
    "Self": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44",
    "Links": [
      {
        "Title": "Members",
        "Href": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44/users",
        "Rel": "Users"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b4109a8f4-f96f58cc-40054c91-9f7aa1db-1457df86256def01b0ccbd44/permissions/projects",
        "Rel": "ProjectPermissions"
      }
    ]
  },
  {
    "Id": "9e1ee34b-f96f-4005-9f7a-1457df86256d",
    "Name": "QA",
    "Description": "QA Team (Testers + Test Managers)",
    "Self": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d",
    "Links": [
      {
        "Title": "Members",
        "Href": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d/users",
        "Rel": "Users"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Href": "http://localhost/api/group/9e1ee34b-f96f-4005-9f7a-1457df86256d/permissions/projects",
        "Rel": "ProjectPermissions"
      }
    ]
  }
]

Status Code

200 - OK

...