Microsoft Teams (version v1.*.*)

create_channel

Create a new channel in a team, as specified in the request body. https://docs.microsoft.com/en-us/graph/api/channel-post?view=graph-rest-1.0

Parameters

team_id (required)

key: team_id

Type: string

$body

Type: object

{
  "membershipType" : "Defaults to standard.",
  "displayName" : "Required string",
  "description" : "Optional channel description."
}

create_channel_message

(Beta) Create a new chatMessage in the specified channel. https://docs.microsoft.com/en-us/graph/api/channel-post-message?view=graph-rest-beta

Parameters

channel_id (required)

Type: string

team_id (required)

Type: string

$body

Type: object

{
  "body" : {
    "contentType" : "string. Possible values: text | html",
    "content" : "string"
  }
}

create_channel_message_reply

Create a new reply to a message in a specified channel. https://docs.microsoft.com/en-us/graph/api/channel-post-messagereply?view=graph-rest-1.0

Parameters

channel_id (required)

Type: string

message_id (required)

Type: string

team_id (required)

Type: string

$body

Type: object

{
  "body" : {
    "contentType" : "string. Possible values: text | html",
    "content" : "string"
  }
}

create_user

Add new entity to users. https://docs.microsoft.com/en-us/graph/api/user-post-users?view=graph-rest-1.0&tabs=http

Parameters

$body

New entity

Type: object

{
  "id" : "Read-only.",
  "deletedDateTime" : "date-time",
  "scopedRoleMemberOf" : [ { } ],
  "companyName" : "The company name which the user is associated. This property can be useful for describing the company that an external user comes from. The maximum length of the company name is 64 characters.Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "createdDateTime" : "The created date of the user object. Read-only. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in).",
  "legalAgeGroupClassification" : "Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Allowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. Refer to the legal age group property definitions for further information. Returned only on $select.",
  "managedAppRegistrations" : [ { } ],
  "mailboxSettings" : { },
  "skills" : [ "string" ],
  "externalUserStateChangeDateTime" : "Shows the timestamp for the latest change to the externalUserState property. Returned only on $select. Supports $filter (eq, ne, not , in).",
  "onenote" : { },
  "onPremisesSyncEnabled" : "true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Read-only. Returned only on $select. Supports $filter (eq, ne, not, in, and eq on null values).",
  "officeLocation" : "The office location in the user's place of business. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "onPremisesSamAccountName" : "Contains the on-premises samAccountName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith).",
  "passwordPolicies" : "Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Returned only on $select. For more information on the default password policies, see Azure AD pasword policies. Supports $filter (ne, not, and eq on null values).",
  "registeredDevices" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "state" : "The state or province in the user's address. Maximum length is 128 characters. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "preferredName" : "The preferred name for the user. Returned only on $select.",
  "presence" : { },
  "events" : [ { } ],
  "mailNickname" : "The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "pastProjects" : [ "string" ],
  "givenName" : "The given name (first name) of the user. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).",
  "deviceManagementTroubleshootingEvents" : [ { } ],
  "onPremisesExtensionAttributes" : { },
  "proxyAddresses" : [ "string" ],
  "creationType" : "Indicates whether the user account was created through one of the following methods: As a regular school or work account (null). As an external account (Invitation). As a local account for an Azure Active Directory B2C tenant (LocalAccount). Through self-service sign-up by an internal user using email verification (EmailVerified). Through self-service sign-up by an external user signing up through a link that is part of a user flow (SelfServiceSignUp). Read-only.Returned only on $select. Supports $filter (eq, ne, not, in).",
  "extensions" : [ { } ],
  "mobilePhone" : "The primary cellular telephone number for the user. Read-only for users synced from on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "oauth2PermissionGrants" : [ { } ],
  "schools" : [ "string" ],
  "drives" : [ { } ],
  "onPremisesDomainName" : "Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only. Returned only on $select.",
  "messages" : [ { } ],
  "consentProvidedForMinor" : "Sets whether consent has been obtained for minors. Allowed values: null, granted, denied and notRequired. Refer to the legal age group property definitions for further information. Returned only on $select. Supports $filter (eq, ne, not, and in).",
  "drive" : { },
  "directReports" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "city" : "The city in which the user is located. Maximum length is 128 characters. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "displayName" : "The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Maximum length is 256 characters. Returned by default. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values), $orderBy, and $search.",
  "joinedTeams" : [ { } ],
  "onlineMeetings" : [ { } ],
  "inferenceClassification" : { },
  "businessPhones" : [ "string" ],
  "externalUserState" : "For an external user invited to the tenant using the invitation API, this property represents the invited user's invitation status. For invited users, the state can be PendingAcceptance or Accepted, or null for all other users. Returned only on $select. Supports $filter (eq, ne, not , in).",
  "identities" : [ {
    "signInType" : "Specifies the user sign-in types in your directory, such as emailAddress, userName, federated, or userPrincipalName. federated represents a unique identifier for a user from an issuer, that can be in any format chosen by the issuer. Setting or updating a userPrincipalName identity will update the value of the userPrincipalName property on the user object. The validations performed on the userPrincipalName property on the user object, for example, verified domains and acceptable characters, will be performed when setting or updating a userPrincipalName identity. Additional validation is enforced on issuerAssignedId when the sign-in type is set to emailAddress or userName. This property can also be set to any custom string.",
    "issuerAssignedId" : "Specifies the unique identifier assigned to the user by the issuer. The combination of issuer and issuerAssignedId must be unique within the organization. Represents the sign-in name for the user, when signInType is set to emailAddress or userName (also known as local accounts).When signInType is set to: emailAddress, (or a custom string that starts with emailAddress like emailAddress1) issuerAssignedId must be a valid email addressuserName, issuerAssignedId must be a valid local part of an email addressSupports $filter. 100 character limit.",
    "issuer" : "Specifies the issuer of the identity, for example facebook.com.For local accounts (where signInType is not federated), this property is the local B2C tenant default domain name, for example contoso.onmicrosoft.com.For external users from other Azure AD organization, this will be the domain of the federated organization, for example contoso.com.Supports $filter. 512 character limit."
  } ],
  "surname" : "The user's surname (family name or last name). Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "deviceEnrollmentLimit" : "The limit on the maximum number of devices that the user is permitted to enroll. Allowed values are 5 or 1000.",
  "memberOf" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "licenseAssignmentStates" : [ { } ],
  "planner" : { },
  "onPremisesProvisioningErrors" : [ { } ],
  "calendar" : { },
  "manager" : {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  },
  "appRoleAssignments" : [ { } ],
  "createdObjects" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "photo" : { },
  "employeeId" : "The employee identifier assigned to the user by the organization. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).",
  "onPremisesSecurityIdentifier" : "Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only. Returned only on $select. Supports $filter (eq) on null values only.",
  "people" : [ { } ],
  "todo" : { },
  "otherMails" : [ "string" ],
  "ownedDevices" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "streetAddress" : "The street address of the user's place of business. Maximum length is 1024 characters. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "calendars" : [ { } ],
  "teamwork" : { },
  "employeeOrgData" : {
    "division" : "The name of the division in which the user works. Returned only on $select. Supports $filter.",
    "costCenter" : "The cost center associated with the user. Returned only on $select. Supports $filter."
  },
  "imAddresses" : [ "string" ],
  "usageLocation" : "A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: US, JP, and GB. Not nullable. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "interests" : [ "string" ],
  "contacts" : [ { } ],
  "lastPasswordChangeDateTime" : "The time when this Azure AD user last changed their password or when their password was created, whichever date the latest action was performed. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned only on $select.",
  "passwordProfile" : { },
  "country" : "The country/region in which the user is located; for example, US or UK. Maximum length is 128 characters. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "onPremisesDistinguishedName" : "Contains the on-premises Active Directory distinguished name or DN. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only. Returned only on $select.",
  "mail" : "The SMTP address for the user, for example, jeff@contoso.onmicrosoft.com.Changes to this property will also update the user's proxyAddresses collection to include the value as an SMTP address. For Azure AD B2C accounts, this property can be updated up to only ten times with unique SMTP addresses. This property cannot contain accent characters.Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith, and eq on null values).",
  "jobTitle" : "The user's job title. Maximum length is 128 characters. Returned by default. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).",
  "postalCode" : "The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code. Maximum length is 40 characters. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).",
  "signInSessionsValidFromDateTime" : "Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications will get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph). If this happens, the application will need to acquire a new refresh token by making a request to the authorize endpoint. Read-only. Use revokeSignInSessions to reset. Returned only on $select.",
  "ownedObjects" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "photos" : [ { } ],
  "accountEnabled" : "true if the account is enabled; otherwise, false. This property is required when a user is created. Returned only on $select. Supports $filter (eq, ne, not, and in).",
  "agreementAcceptances" : [ { } ],
  "assignedPlans" : [ {
    "assignedDateTime" : "The date and time at which the plan was assigned. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
    "service" : "The name of the service; for example, 'Exchange'.",
    "capabilityStatus" : "Condition of the capability assignment. The possible values are Enabled, Warning, Suspended, Deleted, LockedOut. See a detailed description of each value.",
    "servicePlanId" : "A GUID that identifies the service plan."
  } ],
  "responsibilities" : [ "string" ],
  "onPremisesUserPrincipalName" : "Contains the on-premises userPrincipalName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith).",
  "followedSites" : [ { } ],
  "showInAddressList" : "true if the Outlook global address list should contain this user, otherwise false. If not set, this will be treated as true. For users invited through the invitation manager, this property will be set to false. Returned only on $select. Supports $filter (eq, ne, not, in).",
  "transitiveMemberOf" : [ {
    "id" : "Read-only.",
    "deletedDateTime" : "date-time"
  } ],
  "settings" : { },
  "insights" : { },
  "ageGroup" : "Sets the age group of the user. Allowed values: null, minor, notAdult and adult. Refer to the legal age group property definitions for further information. Returned only on $select. Supports $filter (eq, ne, not, and in).",
  "licenseDetails" : [ { } ],
  "onPremisesImmutableId" : "This property is used to associate an on-premises Active Directory user account to their Azure AD user object. This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user's userPrincipalName (UPN) property. NOTE: The $ and _ characters cannot be used when specifying this property. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in)..",
  "chats" : [ { } ],
  "onPremisesLastSyncDateTime" : "Indicates the last time at which the object was synced with the on-premises directory; for example: 2013-02-16T03:04:54Z. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in).",
  "userType" : "A string value that can be used to classify user types in your directory, such as Member and Guest. Returned only on $select. Supports $filter (eq, ne, not, in, and eq on null values). NOTE: For more information about the permissions for member and guest users, see What are the default user permissions in Azure Active Directory?",
  "birthday" : "The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned only on $select.",
  "preferredLanguage" : "The preferred language for the user. Should follow ISO 639-1 Code; for example en-US. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values)",
  "mySite" : "The URL for the user's personal site. Returned only on $select.",
  "isResourceAccount" : "Do not use – reserved for future use.",
  "employeeHireDate" : "The date and time when the user was hired or will start work in case of a future hire. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in).",
  "mailFolders" : [ { } ],
  "aboutMe" : "A freeform text entry field for the user to describe themselves. Returned only on $select.",
  "contactFolders" : [ { } ],
  "provisionedPlans" : [ { } ],
  "department" : "The name for the department in which the user works. Maximum length is 64 characters. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in, and eq on null values).",
  "userPrincipalName" : "The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant's collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property cannot contain accent characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderBy.",
  "authentication" : { },
  "assignedLicenses" : [ {
    "disabledPlans" : [ "uuid" ],
    "skuId" : "The unique identifier for the SKU."
  } ],
  "hireDate" : "The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned only on $select. Note: This property is specific to SharePoint Online. We recommend using the native employeeHireDate property to set and update hire date values using Microsoft Graph APIs.",
  "calendarGroups" : [ { } ],
  "employeeType" : "Captures enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in, startsWith).",
  "activities" : [ { } ],
  "calendarView" : [ { } ],
  "faxNumber" : "The fax number of the user. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).",
  "managedDevices" : [ { } ],
  "outlook" : { }
}

get_channel_message

(Beta) Retrieve a single message (without its replies) in a channel of a team. https://docs.microsoft.com/en-us/graph/api/channel-get-message?view=graph-rest-beta

Parameters

channel_id (required)

Type: string

message_id (required)

Type: string

team_id (required)

Type: string

get_channel_message_reply

(Beta) Get a single reply to a message in a channel of a team. https://docs.microsoft.com/en-us/graph/api/channel-get-messagereply?view=graph-rest-beta

Parameters

channel_id (required)

Type: string

message_id (required)

Type: string

reply_id (required)

Type: string

team_id (required)

Type: string

get_chat_for_user

(Beta) Retrieve a single chat (without its messages). https://docs.microsoft.com/en-us/graph/api/chat-get?view=graph-rest-beta

Parameters

chat_id (required)

Type: string

user_id (required)

Type: string

get_chat_message_for_user

(Beta) Retrieve a single message in a chat. https://docs.microsoft.com/en-us/graph/api/chat-get-message?view=graph-rest-beta

Parameters

chat_id (required)

Type: string

message_id (required)

Type: string

user_id (required)

Type: string

get_me

Retrieve the properties and relationships of the authenticated user. https://docs.microsoft.com/en-us/graph/api/user-get?view=graph-rest-1.0

Parameters

$select

Select properties to be returned

Type: array

[ "string" ]

get_user

Retrieve the properties and relationships of a user. https://docs.microsoft.com/en-us/graph/api/user-get?view=graph-rest-1.0

Parameters

user_id (required)

key: user_id

Type: string

$select

Select properties to be returned

Type: array

[ "string" ]

list_channel_message_replies

(Beta) List all the replies of a message in a channel of a team. This method lists only the replies of the specified message, if any. To get the message itself, call get channel message. https://docs.microsoft.com/en-us/graph/api/channel-list-messagereplies?view=graph-rest-beta

Parameters

channel_id (required)

Type: string

message_id (required)

Type: string

team_id (required)

Type: string

$top

Show only the first n items

Type: integer

list_channel_messages

(Beta) Retrieve the list of messages (without the replies) in a channel of a team. https://docs.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-beta

Parameters

channel_id (required)

Type: string

team_id (required)

Type: string

$top

Show only the first n items

Type: integer

list_channels

List a team's channels. https://docs.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0

Parameters

team_id (required)

key: team_id

Type: string

$expand

Expand related entities

Type: array

[ "string" ]

$filter

Filter items by property values

Type: string

$select

Select properties to be returned

Type: array

[ "string" ]

list_chat_messages

(Beta) Retrieve the list of messages in a chat. https://docs.microsoft.com/en-us/graph/api/chat-list-message?view=graph-rest-beta

Parameters

chat_id (required)

Type: string

list_chat_messages_for_user

(Beta) Retrieve the list of messages in a chat. https://docs.microsoft.com/en-us/graph/api/chat-list-message?view=graph-rest-beta

Parameters

chat_id (required)

Type: string

user_id (required)

Type: string

list_chats

This operation has no parameters

list_chats_for_user

(Beta) Retrieve the list of chats that the user is part of. https://docs.microsoft.com/en-us/graph/api/chat-list?view=graph-rest-beta

Parameters

user_id (required)

Type: string

list_groups

List all the groups in an organization, including but not limited to Microsoft 365 groups. https://docs.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0

Parameters

$filter

Filter items by property values

Type: string

$orderby

Order items by property values

Type: array

[ "string" ]

list_my_chats

This operation has no parameters

list_my_teams

This operation has no parameters

list_teams_for_user

Get the teams in that the user is a direct member of. https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0

Parameters

user_id (required)

key: user_id

Type: string

list_users

Get entities from users. https://docs.microsoft.com/en-us/graph/api/user-list

Parameters

$count

Include count of items

Type: boolean

$expand

Expand related entities

Type: array

[ "string. Possible values: * | appRoleAssignments | createdObjects | directReports | licenseDetails | manager | memberOf | oauth2PermissionGrants | ownedDevices | ownedObjects | registeredDevices | scopedRoleMemberOf | transitiveMemberOf | calendar | calendarGroups | calendars | calendarView | contactFolders | contacts | events | inferenceClassification | mailFolders | messages | outlook | people | drive | drives | followedSites | extensions | agreementAcceptances | managedDevices | managedAppRegistrations | deviceManagementTroubleshootingEvents | planner | insights | settings | onenote | photo | photos | activities | onlineMeetings | presence | authentication | chats | joinedTeams | teamwork | todo" ]

$filter

Filter items by property values

Type: string

$orderby

Order items by property values

Type: array

[ "string. Possible values: id | id desc | deletedDateTime | deletedDateTime desc | accountEnabled | accountEnabled desc | ageGroup | ageGroup desc | assignedLicenses | assignedLicenses desc | assignedPlans | assignedPlans desc | businessPhones | businessPhones desc | city | city desc | companyName | companyName desc | consentProvidedForMinor | consentProvidedForMinor desc | country | country desc | createdDateTime | createdDateTime desc | creationType | creationType desc | department | department desc | displayName | displayName desc | employeeHireDate | employeeHireDate desc | employeeId | employeeId desc | employeeOrgData | employeeOrgData desc | employeeType | employeeType desc | externalUserState | externalUserState desc | externalUserStateChangeDateTime | externalUserStateChangeDateTime desc | faxNumber | faxNumber desc | givenName | givenName desc | identities | identities desc | imAddresses | imAddresses desc | isResourceAccount | isResourceAccount desc | jobTitle | jobTitle desc | lastPasswordChangeDateTime | lastPasswordChangeDateTime desc | legalAgeGroupClassification | legalAgeGroupClassification desc | licenseAssignmentStates | licenseAssignmentStates desc | mail | mail desc | mailNickname | mailNickname desc | mobilePhone | mobilePhone desc | officeLocation | officeLocation desc | onPremisesDistinguishedName | onPremisesDistinguishedName desc | onPremisesDomainName | onPremisesDomainName desc | onPremisesExtensionAttributes | onPremisesExtensionAttributes desc | onPremisesImmutableId | onPremisesImmutableId desc | onPremisesLastSyncDateTime | onPremisesLastSyncDateTime desc | onPremisesProvisioningErrors | onPremisesProvisioningErrors desc | onPremisesSamAccountName | onPremisesSamAccountName desc | onPremisesSecurityIdentifier | onPremisesSecurityIdentifier desc | onPremisesSyncEnabled | onPremisesSyncEnabled desc | onPremisesUserPrincipalName | onPremisesUserPrincipalName desc | otherMails | otherMails desc | passwordPolicies | passwordPolicies desc | passwordProfile | passwordProfile desc | postalCode | postalCode desc | preferredLanguage | preferredLanguage desc | provisionedPlans | provisionedPlans desc | proxyAddresses | proxyAddresses desc | showInAddressList | showInAddressList desc | signInSessionsValidFromDateTime | signInSessionsValidFromDateTime desc | state | state desc | streetAddress | streetAddress desc | surname | surname desc | usageLocation | usageLocation desc | userPrincipalName | userPrincipalName desc | userType | userType desc | mailboxSettings | mailboxSettings desc | deviceEnrollmentLimit | deviceEnrollmentLimit desc | aboutMe | aboutMe desc | birthday | birthday desc | hireDate | hireDate desc | interests | interests desc | mySite | mySite desc | pastProjects | pastProjects desc | preferredName | preferredName desc | responsibilities | responsibilities desc | schools | schools desc | skills | skills desc" ]

Search items by search phrases

Type: string

$select

Select properties to be returned

Type: array

[ "string. Possible values: id | deletedDateTime | accountEnabled | ageGroup | assignedLicenses | assignedPlans | businessPhones | city | companyName | consentProvidedForMinor | country | createdDateTime | creationType | department | displayName | employeeHireDate | employeeId | employeeOrgData | employeeType | externalUserState | externalUserStateChangeDateTime | faxNumber | givenName | identities | imAddresses | isResourceAccount | jobTitle | lastPasswordChangeDateTime | legalAgeGroupClassification | licenseAssignmentStates | mail | mailNickname | mobilePhone | officeLocation | onPremisesDistinguishedName | onPremisesDomainName | onPremisesExtensionAttributes | onPremisesImmutableId | onPremisesLastSyncDateTime | onPremisesProvisioningErrors | onPremisesSamAccountName | onPremisesSecurityIdentifier | onPremisesSyncEnabled | onPremisesUserPrincipalName | otherMails | passwordPolicies | passwordProfile | postalCode | preferredLanguage | provisionedPlans | proxyAddresses | showInAddressList | signInSessionsValidFromDateTime | state | streetAddress | surname | usageLocation | userPrincipalName | userType | mailboxSettings | deviceEnrollmentLimit | aboutMe | birthday | hireDate | interests | mySite | pastProjects | preferredName | responsibilities | schools | skills | appRoleAssignments | createdObjects | directReports | licenseDetails | manager | memberOf | oauth2PermissionGrants | ownedDevices | ownedObjects | registeredDevices | scopedRoleMemberOf | transitiveMemberOf | calendar | calendarGroups | calendars | calendarView | contactFolders | contacts | events | inferenceClassification | mailFolders | messages | outlook | people | drive | drives | followedSites | extensions | agreementAcceptances | managedDevices | managedAppRegistrations | deviceManagementTroubleshootingEvents | planner | insights | settings | onenote | photo | photos | activities | onlineMeetings | presence | authentication | chats | joinedTeams | teamwork | todo" ]

$skip

Skip the first n items

Type: integer

$top

Show only the first n items

Type: integer

ConsistencyLevel

Indicates the requested consistency level. Documentation URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Type: string