workPosition resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents detailed information about work positions associated with a user's profile.

This resource type inherits from itemFacet.

Methods

Method	Return type	Description
List positions	workPosition collection	Get the workPosition resources from the positions navigation property.
Create workPosition	workPosition	Create a new workPosition object.
Get workPosition	workPosition	Read the properties and relationships of a workPosition object.
Update workPosition	workPosition	Update the properties of a workPosition object.
Delete workPosition	None	Deletes a workPosition object.

Properties

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.
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.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "@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"
}