Update identityUserFlowAttribute

Namespace: microsoft.graph

Update the properties of a identityUserFlowAttribute object. Only custom user flow attributes can be updated.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) IdentityUserFlow.ReadWrite.All
Delegated (personal Microsoft account) Not supported.
Application IdentityUserFlow.ReadWrite.All

The work or school account needs to belong to one of the following roles:

  • Global administrator
  • External Identity User Flow Attributes administrator

HTTP request

PATCH /identity/userFlowAttributes/{id}

Request headers

Name Description
Authorization Bearer {token}. Required.
Content-Type application/json. Required.

Request body

In the request body, provide a JSON object with one or more properties that need to be updated for an identityUserFlowAttribute object.

Note: Only the description property can be updated.

Property Type Description
description String The description of the user flow attribute. It is shown to the user at the time of sign up.


If successful, this method returns a 204 No Content response code. If unsuccessful, a 4xx error will be returned with specific details.



The following is an example of the request.

PATCH https://graph.microsoft.com/v1.0/identity/userFlowAttributes/extension_d09380e2b4c642b9a203fb816a04a7ad_Hobby
Content-type: application/json

  "description": "Your new hobby"


The following is an example of the response.

HTTP/1.1 204 No Content