Versions Compared

Key

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

...

These are the expected status codes returned by the service - in . 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).

...

These are the expected status codes returned by the service - in . 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).

...

Example - Get User

Example of fetching a user

Request Headers

KeyValueDescription
Acceptapplication/json

Response Headers

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

Response Body

Code Block
languagenone
{
  "Id": "96ed2fc6-bab3-4af3-9ade-3c7039279a1d",
  "UserName": "joeb",
  "Email": "joeb@unknown.net",
  "FirstName": "Joe",
  "LastName": "Bloggs",
  "Phone": "(09)-555-999",
  "LastLogIn": null,
  "Enabled": true,
  "IsExternal": false,
  "Self": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d",
  "Links": [
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/password",
      "Rel": "ChangePassword"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/permissions/global",
      "Rel": "GlobalPermissions"
    },
    {
      "Title": "Group Memberships",
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/groups",
      "Rel": "Groups"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/notifications",
      "Rel": "Notifications"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/permissions/projects",
      "Rel": "ProjectPermissions"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/mailmessages",
      "Rel": "MailMessages"
    }
  ]
}

Status Code

200 - OK

...

These are the expected status codes returned by the service - in . 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).

...

Example - Update existing User

Updating basic details of a user.

Request Headers

KeyValueDescription
Acceptapplication/json

Request Parameters

KeyValueDescription
{id}96ED2FC6-BAB3-4AF3-9ADE-3C7039279A1DID of the user to update

Request Body

Code Block
languagenone
{
  "UserName": "joeb",
  "Email": "joeb@unknown.net",
  "FirstName": "Joe",
  "LastName": "Bloggs",
  "Phone": "(09)-555-999"
}

Response Headers

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

Response Body

Code Block
languagenone
{
  "Id": "96ed2fc6-bab3-4af3-9ade-3c7039279a1d",
  "UserName": "joeb",
  "Email": "joeb@unknown.net",
  "FirstName": "Joe",
  "LastName": "Bloggs",
  "Phone": "(09)-555-999",
  "LastLogIn": null,
  "Enabled": true,
  "IsExternal": false,
  "Self": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d",
  "Links": [
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/password",
      "Rel": "ChangePassword"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/permissions/global",
      "Rel": "GlobalPermissions"
    },
    {
      "Title": "Group Memberships",
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/groups",
      "Rel": "Groups"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/notifications",
      "Rel": "Notifications"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/permissions/projects",
      "Rel": "ProjectPermissions"
    },
    {
      "Href": "http://localhost/api/user/96ed2fc6-bab3-4af3-9ade-3c7039279a1d/mailmessages",
      "Rel": "MailMessages"
    }
  ]
}

Status Code

200 - OK

...