Profile Edit API - Honors
This sub-resource API will allow you to create, update, and delete honors of a member. See Honor Fields for a description of the fields available within this object.
Supported Methods
CREATE | PARTIAL_UPDATE | DELETE
CREATE
POST https://api.linkedin.com/v2/people/id={person ID}/honors
sample request body
{
"description": {
"localized": {
"en_US": {
"rawText": "Best developer ever."
}
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"issueDate": {
"month": 1,
"year": 2013
},
"issuer": {
"localized": {
"en_US": "LinkedIn"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"occupation": "urn:li:position:(urn:li:person:1234ABC,677616236)",
"title": {
"localized": {
"en_US": "Awesome Award"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
}
}
Note
A successful response will return a 201 Created
HTTP status code. To record the created entity's id
, refer to the header x-linkedin-id
field.
PARTIAL UPDATE
POST https://api.linkedin.com/v2/people/id={person ID}/honors/{honor ID}
sample request body
{
"patch": {
"$set": {
"title": {
"localized": {
"en_US": "Awesome Award"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
}
}
}
}
Sample Json to delete one or more fields. If you attempt to delete a field that is mandatory, the API will return a 422 Error Response. See Honors Fields for allowed list of fields for this resource.
sample request body
{
"patch": {
"$delete": [
"field1",
"field2"
]
}
}
DELETE
DELETE https://api.linkedin.com/v2/people/id={person ID}/honors/{honor ID}