Modify an account member

PATCH
/api/v2/members/:id

Update a single account member. Updating a member uses a JSON patch representation of the desired changes. To learn more, read Updates.

To update fields in the account member object that are arrays, set the path to the name of the field and then append /<array index>. Use /0 to add to the beginning of the array. Use /- to add to the end of the array. For example, to add a new custom role to a member, use the following request body:

  [
    {
      "op": "add",
      "path": "/customRoles/0",
      "value": "some-role-id"
    }
  ]

You can update only an account member’s role or custom role using a JSON patch. Members can update their own names and email addresses though the LaunchDarkly UI.

When SAML SSO or SCIM is enabled for the account, account members are managed in the Identity Provider (IdP). Requests to update account members will succeed, but the IdP will override the update shortly afterwards.

Path parameters

idstringRequired

The member ID

Request

This endpoint expects a list of objects.
list of objects

Response

Member response

_linksmap from strings to objects

The location and content type of related resources

_idstring

The member’s ID

rolestring

The member’s built-in role. If the member has no custom roles, this role will be in effect.

emailstring

The member’s email address

_pendingInviteboolean

Whether the member has a pending invitation

_verifiedboolean

Whether the member’s email address has been verified

customRoleslist of strings

The set of custom roles (as keys) assigned to the member

mfastring

Whether multi-factor authentication is enabled for this member

_lastSeenlong

The member’s last session date (as Unix milliseconds since epoch)

creationDatelong

Timestamp of when the member was created

firstNamestringOptional

The member’s first name

lastNamestringOptional

The member’s last name

_pendingEmailstringOptional

The member’s email address before it has been verified, for accounts where email verification is required

excludedDashboardslist of stringsOptional

Default dashboards that the member has chosen to ignore

_lastSeenMetadataobjectOptional

Additional metadata associated with the member’s last session, for example, whether a token was used

_integrationMetadataobjectOptional

Details on the member account in an external source, if this member is provisioned externally

teamslist of objectsOptional

Details on the teams this member is assigned to

permissionGrantslist of objectsOptional

A list of permission grants. Permission grants allow a member to have access to a specific action, without having to create or update a custom role.

oauthProviderslist of stringsOptional

A list of OAuth providers

versionintegerOptional

Version of the current configuration

roleAttributesmap from strings to lists of stringsOptional

The role attributes for the member

Errors

Account members (beta)
Built with