Profile Edit API - Positions

This sub-resource API will allow you to create, update, and delete positions of a member. See Position 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}/positions

sample request body

{
    "company": "urn:li:organization:1337",
    "companyName": {
        "localized": {
            "en_US": "LinkedIn"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "description": {
        "localized": {
            "en_US": {
                "rawText": "Awesome developer manager!"
            }
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "location": {
        "countryCode": "us",
        "regionCode": 84
    },
    "startMonthYear": {
        "month": 1,
        "year": 2014
    },
    "title": {
        "localized": {
            "en_US": "Engineering Manager"
        },
        "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}/positions/{position ID}

sample json request body

{
    "patch": {
        "$set": {
            "endMonthYear": {
                "month": 1,
                "year": 2016
            },
            "title": {
                "localized": {
                    "en_US": "Principal Software Engineer"
                },
                "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 Position Fields for allowed list of fields for this resource

sample json request body

{
    "patch": {
        "$delete": [
            "field1",
            "field2"
        ]
    }
}

DELETE

DELETE https://api.linkedin.com/v2/people/id={person ID}/positions/{position ID}