update_user

Update a user.

Input fields

address_1 (String)

User address line 1. Maximum length is 255 characters.

address_2 (String)

User address line 2. Maximum length is 255 characters.

city (String)

User city. Maximum length is 255 characters.

country_code (String)

User country code (ISO 3166-1). Maximum length is 4 characters.

email (String)

The email address for the user. Must be unique across all FieldAgent users. Maximum length is 255 characters.

first_name (String)

The first name of the user. Maximum length is 255 characters.

last_name (String)

The last name of the user. Maximum length is 255 characters.

sentera_id (ID!)

User Sentera ID (ready only).

state (String)

User state/province/region code (ISO 3166-2). Maximum length is 4 characters.

zip_code (String)

User zip code. Maximum length is 255 characters.

Return fields

address_1 (String)

User address line 1.

address_2 (String)

User address line 2.

city (String)

User city.

country_code (String!)

User country code (ISO 3166-1).

email (String!)

The email address for the user.

enterprise_license_agreement (Boolean!)

Has this user's employer opted into the enterprise license agreement.

first_name (String!)

The first name of the user.

last_name (String)

The last name of the user.

license_type (UserLicense!)

The type of license currently assigned to the user.

logos (LogosQueryResult)

A list of logos for this user.

Argument Type Description
pagination Pagination!

Paginate the results.

sentera_id ID

Retrieve the logo with the given Sentera ID.

organization (Organization!)

The organization this user belongs to.

organization_maps (JSON!)
Deprecation notice

Please use the organizations query instead to build the organization hierarchy.

A list of organization hierarchies comprised of the user's home organization and any organizations the user is partnered with, returned as a JSON array of hashes. Available keys in each hash are sentera_id (string), name (string) and children (array). This structure is recursive.

phone_number (String)

The phone number for the user.

preferences (UserPreferences!)

The app preferences for this user.

roles ([UserRole!]!)

An array of all of the user's roles.

sentera_id (ID!)

A system-generated key identifying a specific instance of a user.

signatures (SignaturesQueryResult)

A list of signatures for this user.

Argument Type Description
pagination Pagination!

Paginate the results.

sentera_id ID

Retrieve the signature with the given Sentera ID.

state (String)

User state/province/region code (ISO 3166-2).

status (UserStatus!)

The current status of the user.

zip_code (String)

User zip code.

Examples

Update User

Updates a user. This mutation can only be run by a user with the client admin role, and can only be used on users in the current user's organization.

Try this example in GraphiQL
mutation UpdateUser{
  update_user(
    sentera_id: "2idjv9o_US_bw1kAcmeOrg_CV_prod_9d89c370_190528_170322"
    first_name: "Nancy"
  ) {
  sentera_id
  first_name
  }
}

{
  "data": {
  "update_user": {
    "first_name": "Nancy"
  }
  }
}