diff --git a/api-reference/beta/api/onemailotpsendlistener-update.md b/api-reference/beta/api/onemailotpsendlistener-update.md new file mode 100644 index 00000000000..3c7a65d203c --- /dev/null +++ b/api-reference/beta/api/onemailotpsendlistener-update.md @@ -0,0 +1,119 @@ +--- +title: "Update onEmailOtpSendListener" +description: "Update the properties of an onEmailOtpSendListener object." +author: "AlexanderMars" +ms.localizationpriority: medium +ms.subservice: "entra-sign-in" +doc_type: apiPageType +--- + +# Update onEmailOtpSendListener + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Update the properties of an [onEmailOtpSendListener](../resources/onemailotpsendlistener.md) object. + +## Permissions + +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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/onemailotpsendlistener-update-permissions.md)] + +## HTTP request + + +``` http +PATCH /onEmailOtpSendListener +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| + +## Request body + +[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] + + +**TODO: Remove properties that don't apply** +|Property|Type|Description| +|:---|:---|:---| +|priority|Int32|**TODO: Add Description** Inherited from [authenticationEventListener](../resources/authenticationeventlistener.md). Required.| +|conditions|[authenticationConditions](../resources/authenticationconditions.md)|**TODO: Add Description** Inherited from [authenticationEventListener](../resources/authenticationeventlistener.md). Optional.| +|authenticationEventsFlowId|String|**TODO: Add Description** Inherited from [authenticationEventListener](../resources/authenticationeventlistener.md). Optional.| +|handler|[onOtpSendHandler](../resources/onotpsendhandler.md)|**TODO: Add Description** Optional.| + + + +## Response + +If successful, this method returns a `200 OK` response code and an updated [onEmailOtpSendListener](../resources/onemailotpsendlistener.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +PATCH https://graph.microsoft.com/beta/onEmailOtpSendListener +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.onEmailOtpSendListener", + "priority": "Integer", + "conditions": { + "@odata.type": "microsoft.graph.authenticationConditions" + }, + "authenticationEventsFlowId": "String", + "handler": { + "@odata.type": "microsoft.graph.onOtpSendHandler" + } +} +``` + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.onEmailOtpSendListener", + "id": "ace45024-ab54-1567-de2e-fe83afd01a03", + "priority": "Integer", + "conditions": { + "@odata.type": "microsoft.graph.authenticationConditions" + }, + "authenticationEventsFlowId": "String", + "handler": { + "@odata.type": "microsoft.graph.onOtpSendHandler" + } +} +``` +