Versions Compared

Key

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

...

Example - Get All Users

An example of fetching all users in group.

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}0832C85F-E532-472F-92E1-287995CE3726ID of the group

Response Headers

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

Response Body

Code Block
languagenone
[
  {
    "Id": "00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53",
    "UserName": "joeb",
    "Email": "joeb@unknown.net",
    "FirstName": "Joe",
    "LastName": "Bloggs",
    "Phone": "(09)-555-999",
    "LastLogIn": null,
    "Self": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53",
    "Links": [
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/password",
        "Rel": "ChangePassword"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Title": "Group Memberships",
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/groups",
        "Rel": "Groups"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/notifications",
        "Rel": "Notifications"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/permissions/projects",
        "Rel": "ProjectPermissions"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/mailmessages",
        "Rel": "MailMessages"
      }
    ]
  },
  {
    "Id": "0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8",
    "UserName": "janed",
    "Email": "janed@unknown.net",
    "FirstName": "Jane",
    "LastName": "Doe",
    "Phone": "(09)-555-999",
    "LastLogIn": null,
    "Self": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8",
    "Links": [
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/password",
        "Rel": "ChangePassword"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Title": "Group Memberships",
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/groups",
        "Rel": "Groups"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/notifications",
        "Rel": "Notifications"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/permissions/projects",
        "Rel": "ProjectPermissions"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/mailmessages",
        "Rel": "MailMessages"
      }
    ]
  }
]

Status Code

200 - OK

Example - Get Users filtered by first name

An example of fetching a set of users by first name belonging to the group, by using the ODATA $filter query parameter.

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}0832C85F-E532-472F-92E1-287995CE3726ID of the group
$filterFirstName eq 'Jane'The ODATA $filter parameter, this query parameter should be url encoded i.e. $filter=FirstName%20eq%20'Jane'.

Response Headers

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

Response Body

Code Block
languagenone
[
  {
    "Id": "0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8",
    "UserName": "janed",
    "Email": "janed@unknown.net",
    "FirstName": "Jane",
    "LastName": "Doe",
    "Phone": "(09)-555-999",
    "LastLogIn": null,
    "Self": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8",
    "Links": [
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/password",
        "Rel": "ChangePassword"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Title": "Group Memberships",
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/groups",
        "Rel": "Groups"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/notifications",
        "Rel": "Notifications"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/permissions/projects",
        "Rel": "ProjectPermissions"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/mailmessages",
        "Rel": "MailMessages"
      }
    ]
  }
]

Status Code

200 - OK

...

Example - Set Members

Sets the users who are members of this group.

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}0832C85F-E532-472F-92E1-287995CE3726ID of the group

Request Body

Code Block
languagenone
{
  "Items": [
    {
      "Id": "00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53"
    },
    {
      "Id": "0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8"
    }
  ]
}

Response Headers

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

Response Body

Code Block
languagenone
[
  {
    "Id": "00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53",
    "UserName": "joeb",
    "Email": "joeb@unknown.net",
    "FirstName": "Joe",
    "LastName": "Bloggs",
    "Phone": "(09)-555-999",
    "LastLogIn": null,
    "Self": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53",
    "Links": [
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/password",
        "Rel": "ChangePassword"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Title": "Group Memberships",
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/groups",
        "Rel": "Groups"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/notifications",
        "Rel": "Notifications"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/permissions/projects",
        "Rel": "ProjectPermissions"
      },
      {
        "Href": "http://localhost/api/user/00000000c699d96a-0000a63b-00004087-0000bc04-000000000000c429de15dd53/mailmessages",
        "Rel": "MailMessages"
      }
    ]
  },
  {
    "Id": "0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8",
    "UserName": "janed",
    "Email": "janed@unknown.net",
    "FirstName": "Jane",
    "LastName": "Doe",
    "Phone": "(09)-555-999",
    "LastLogIn": null,
    "Self": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8",
    "Links": [
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/password",
        "Rel": "ChangePassword"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/permissions/global",
        "Rel": "GlobalPermissions"
      },
      {
        "Title": "Group Memberships",
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/groups",
        "Rel": "Groups"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/notifications",
        "Rel": "Notifications"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/permissions/projects",
        "Rel": "ProjectPermissions"
      },
      {
        "Href": "http://localhost/api/user/0000000035f32f5b-0000a69e-00004b16-0000a59c-000000000000ebfb988b4bf8/mailmessages",
        "Rel": "MailMessages"
      }
    ]
  }
]

Status Code

200 - OK

...