Share via

Profile Edit API - Honors

  • Article

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}