| title | workPosition resource type |
|---|---|
| description | workPosition resource type |
| ms.localizationpriority | medium |
| author | kevinbellinger |
| ms.subservice | people |
| doc_type | resourcePageType |
| ms.date | 07/22/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents detailed information about work positions associated with a user's profile.
This resource type inherits from itemFacet.
| Method | Return type | Description |
|---|---|---|
| List | workPosition collection | Get the workPosition resources from the positions navigation property. |
| Create | workPosition | Create a new workPosition object. |
| Get | workPosition | Read the properties and relationships of a workPosition object. |
| Update | workPosition | Update the properties of a workPosition object. |
| Delete | None | Deletes a workPosition object. |
| Property | Type | Description |
|---|---|---|
| allowedAudiences | String | The audiences that are able to see the values contained within the entity. Inherited from itemFacet. The 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. |
| createdBy | identitySet | Provides the identifier of the user and/or application that created the entity. Inherited from itemFacet. |
| createdDateTime | DateTimeOffset | Provides the dateTimeOffset for when the entity was created. Inherited from itemFacet. |
| detail | positionDetail | Contains detailed information about the position. |
| id | String | Identifier used for individually addressing the entity. Inherited from entity |
| 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. |
| lastModifiedBy | identitySet | Provides the identifier of the user and/or application that last modified the entity. Inherited from itemFacet. |
| lastModifiedDateTime | DateTimeOffset | Provides the dateTimeOffset for when the entity was created. Inherited from itemFacet. |
| 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. |
None.
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.workPosition",
"id": "String (identifier)",
"allowedAudiences": "String",
"inference": {
"@odata.type": "microsoft.graph.inferenceData"
},
"createdDateTime": "String (timestamp)",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"source": {
"@odata.type": "microsoft.graph.personDataSource"
},
"categories": [
"String"
],
"detail": {
"@odata.type": "microsoft.graph.positionDetail"
},
"manager": {
"@odata.type": "microsoft.graph.relatedPerson"
},
"colleagues": [
{
"@odata.type": "microsoft.graph.relatedPerson"
}
],
"isCurrent": "Boolean"
}