Jump to

• Request
• Response

Update subset of properties of a user

patch

/learn.rest/v1/users/{userId}

Request

Supported Media Types

• application/json

Path Parameters

• userId: number
  Unique identifier of User.

Body ()

User object that needs to be updated

Root Schema : User

Type: object

Show Source

• city(optional): string
• company(optional): string
• country(optional): string
• department(optional): string
• email(optional): string
• email2(optional): string
• employeeId(optional): string
• fax(optional): string
• firstName(optional): string
• gender(optional): string
  Allowed Values: [ "male", "female" ]

  enum for gender are: male, female
• includeInSearchFlag(optional): boolean
  Default Value: false
• jobTitle(optional): string
• lastName(optional): string
• managerName(optional): string
• officeName(optional): string
• pager(optional): string
• pagerInteractive(optional): string
• passwordValidUntilDate(optional): string
• phoneDaytime(optional): string
• phoneEvening(optional): string
• phoneMobile(optional): string
• postalCode(optional): string
• profession(optional): string
• ssn(optional): string
• state(optional): string
• street1(optional): string
• street2(optional): string
• username(optional): string
  Username of the user

{
    "type":"object",
    "properties":{
        "username":{
            "type":"string",
            "description":"Username of the user"
        },
        "firstName":{
            "type":"string"
        },
        "lastName":{
            "type":"string"
        },
        "street1":{
            "type":"string"
        },
        "street2":{
            "type":"string"
        },
        "city":{
            "type":"string"
        },
        "postalCode":{
            "type":"string"
        },
        "state":{
            "type":"string"
        },
        "country":{
            "type":"string"
        },
        "phoneDaytime":{
            "type":"string"
        },
        "phoneEvening":{
            "type":"string"
        },
        "phoneMobile":{
            "type":"string"
        },
        "fax":{
            "type":"string"
        },
        "pager":{
            "type":"string"
        },
        "pagerInteractive":{
            "type":"string"
        },
        "email":{
            "type":"string"
        },
        "email2":{
            "type":"string"
        },
        "gender":{
            "type":"string",
            "description":"enum for gender are: male, female",
            "enum":[
                "male",
                "female"
            ]
        },
        "ssn":{
            "type":"string"
        },
        "employeeId":{
            "type":"string"
        },
        "company":{
            "type":"string"
        },
        "officeName":{
            "type":"string"
        },
        "department":{
            "type":"string"
        },
        "jobTitle":{
            "type":"string"
        },
        "profession":{
            "type":"string"
        },
        "managerName":{
            "type":"string"
        },
        "passwordValidUntilDate":{
            "type":"string"
        },
        "includeInSearchFlag":{
            "type":"boolean",
            "default":false
        }
    },
    "example":{
        "username":"cwallace",
        "firstName":"Chris",
        "lastName":"Wallace",
        "street1":"500 Oracle Parkway",
        "street2":"suite 500",
        "city":"Redwood Shores",
        "state":"CA",
        "postalCode":"94065",
        "country":"US",
        "officeName":"HQ",
        "gender":"male",
        "includeInSearchFlag":true,
        "jobTitle":"Product Manager",
        "managerName":"n/a",
        "pagerInteractive":"n/a",
        "ssn":"n/a",
        "email2":"n/a",
        "pager":"n/a",
        "company":"Oracle",
        "fax":"n/a",
        "department":"Product Development",
        "phoneEvening":"n/a",
        "email":"[e-mail]",
        "phoneDaytime":"+1.650.506.7000",
        "profession":"Product Management",
        "phoneMobile":"+1.800.392.2999",
        "employeeId":"n/a",
        "passwordValidUntilDate":"2016-10-12T11:00:00-04:00"
    },
    "xml":{
        "name":"User"
    }
}

Example:

{
    "username":"cwallace",
    "firstName":"Chris",
    "lastName":"Wallace",
    "street1":"500 Oracle Parkway",
    "street2":"suite 500",
    "city":"Redwood Shores",
    "state":"CA",
    "postalCode":"94065",
    "country":"US",
    "officeName":"HQ",
    "gender":"male",
    "includeInSearchFlag":true,
    "jobTitle":"Product Manager",
    "managerName":"n/a",
    "pagerInteractive":"n/a",
    "ssn":"n/a",
    "email2":"n/a",
    "pager":"n/a",
    "company":"Oracle",
    "fax":"n/a",
    "department":"Product Development",
    "phoneEvening":"n/a",
    "email":"[e-mail]",
    "phoneDaytime":"+1.650.506.7000",
    "profession":"Product Management",
    "phoneMobile":"+1.800.392.2999",
    "employeeId":"n/a",
    "passwordValidUntilDate":"2016-10-12T11:00:00-04:00"
}

Security

• auth: basic
  Type: basic

  Description: Basic Authentication

Back to Top

Response

Supported Media Types

• application/xml
• application/json

200 Response

Resource updated.

400 Response

Request has incorrect syntax or does not contain a field that is required.

401 Response

Authentication refused for provided credentials or token invalid.

Headers

• WWW_Authenticate: string

404 Response

Resource not found.

500 Response

Internal server error.

Back to Top