Update User

Update user

PUT/v1/users/{userId}

Use it in a workflow

Add a step and choose the Talon.One connector.
Pick the Update User action (under management).
Fill in the fields below, then reference the result from later steps as {{updateUser.response.data}}.

Request

Path parameters

userIdinteger (int64)required

The ID of the user.

Request body

Enter the body as JSON in the step's Body field.

namestring

Name of the user.

statestring

The state of the user. - `deactivated`: The user has been deactivated. - `active`: The user is active. **Note**: Only `admin` users can update the state of another user.

One ofdeactivatedactive

isAdminboolean

Indicates whether the user is an `admin`.

policystring

Indicates the access level of the user.

rolesarray<integer (int64)>

A list of the IDs of the roles assigned to the user. **Note**: To find the ID of a role, use the [List roles](/management-api#tag/Roles/operation/listAllRolesV2) endpoint.

applicationNotificationSubscriptionsobject

Application notifications that the user is subscribed to.

json

{
  "name": "John Doe",
  "state": "deactivated",
  "isAdmin": false,
  "policy": "",
  "roles": [
    1,
    3
  ],
  "applicationNotificationSubscriptions": {}
}

Response

Returns 200 with an object. Read it in later steps with {{updateUser.response.data.<field>}}.

idinteger (int64)

The internal ID of this entity.

createdstring (date-time)

The time this entity was created.

modifiedstring (date-time)

The time this entity was last modified.

emailstring (email)

The email address associated with the user profile.

accountIdinteger (int64)

The ID of the account that owns this entity.

namestring

Name of the user.

statestring

State of the user.

One ofinvitedactivedeactivated

inviteTokenstring

Invitation token of the user. **Note**: If the user has already accepted their invitation, this is `null`.

isAdminboolean

Indicates whether the user is an `admin`.

policyobject

Access level of the user.

rolesarray<integer (int64)>

A list of the IDs of the roles assigned to the user.

authMethodstring

Authentication method for this user.

applicationNotificationSubscriptionsobject

Application notifications that the user is subscribed to.

lastSignedInstring (date-time)

Timestamp when the user last signed in to Talon.One.

lastAccessedstring (date-time)

Timestamp of the user's last activity after signing in to Talon.One.

latestFeedTimestampstring (date-time)

Timestamp when the user was notified for feed.

additionalAttributesobject

Additional user attributes, created and used by external identity providers.

json

{
  "id": 6,
  "created": {},
  "modified": {},
  "email": "john.doe@example.com",
  "accountId": 3886,
  "name": "John Doe",
  "state": "invited",
  "inviteToken": "Gy9b8w1irmQtEPo5RmbMmSPheL5h4",
  "policy": {
    "Role": 127
  },
  "isAdmin": false,
  "roles": [
    71
  ],
  "authMethod": "basic_auth"
}

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.

Was this page helpful?