title | description | ms.localizationpriority | author | ms.subservice | doc_type |
---|---|---|---|---|---|
Create workPosition |
Use this API to create a new workPosition. |
medium |
kevinbellinger |
people |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Use this API to create a new workPosition in a user's profile.
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
POST /me/profile/positions
POST /users/{id | userPrincipalName}/profile/positions
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Content-Type | application/json. Required. |
In the request body, supply a JSON representation of workPosition object.
The following table shows the properties that are possible to set when you create a new workPosition object in a user's profile.
Property | Type | Description |
---|---|---|
allowedAudiences | String | The audiences that are able to see the values contained within the entity. Inherited from itemFacet. Possible values are: me , family , contacts , groupMembers , organization , federatedOrganizations , everyone , unknownFutureValue . |
categories | String collection | Categories that the user has associated with this position. |
colleagues | relatedPerson collection | Colleagues that are associated with this position. |
detail | positionDetail | Contains detailed information about the position. |
inference | inferenceData | Contains inference detail if the entity is inferred by the creating or modifying application. Inherited from itemFacet. |
isCurrent | Boolean | Denotes whether or not the position is current. |
manager | relatedPerson | Contains detail of the user's manager in this position. |
source | personDataSource | Where the values originated if synced from another service. Inherited from itemFacet. |
If successful, this method returns 201, Created
response code and a new workPosition object in the response body.
The following example shows a request.
POST https://graph.microsoft.com/beta/me/profile/positions
Content-type: application/json
{
"detail": {
"company": {
"displayName": "Adventureworks Ltd.",
"department": "Consulting",
"officeLocation": "AW23/344",
"address": {
"type": "business",
"street": "123 Patriachy Ponds",
"city": "Moscow",
"countryOrRegion": "Russian Federation",
"postalCode": "RU-34621"
},
"webUrl": "https://www.adventureworks.com"
},
"jobTitle": "Senior Product Branding Manager II",
"role": "consulting"
},
"isCurrent": true
}
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"source": null,
"categories": null,
"detail": {
"company": {
"displayName": "Adventureworks Ltd.",
"pronunciation": null,
"department": "Consulting",
"officeLocation": "AW23/344",
"address": {
"type": "business",
"postOfficeBox": null,
"street": "123 Patriachy Ponds",
"city": "Moscow",
"state": null,
"countryOrRegion": "Russian Federation",
"postalCode": "RU-34621"
},
"webUrl": "https://www.adventureworks.com"
},
"description": null,
"endMonthYear": null,
"jobTitle": "Senior Product Branding Manager II",
"role": "consulting",
"startMonthYear": "datetime-value",
"summary": null
},
"manager": null,
"colleagues": null,
"isCurrent": true
}