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:0000",
  "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
  },
  "geoPositionLocation": {
    "displayLocationName": {
      "localized": {
        "en_US": "San Francisco Bay Area"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    }
  },
  "locationName": {
    "localized": {
      "en_US": "San Francisco Bay Area"
    },
    "preferredLocale": {
      "country": "US",
      "language": "en"
    }
  },
  "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"
        }
      },
      "geoPositionLocation": {
        "displayLocationName": {
          "localized": {
            "en_US": "San Francisco Bay Area"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        }
      },
      "locationName": {
        "localized": {
          "en_US": "San Francisco Bay Area"
        },
        "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}