Core PlatformUser Identity

User Attribute Reference

View as Markdown

User Attributes are what make up a user’s identity within Moveworks. Moveworks exposes these attributes to be used in API requests & launch options for ease of development.

List of available User Attributes

namedescriptiontype
custom_attributesThis can be used to dot walk into custom attributesobj
first_nameThe user’s first namestring
last_nameThe user’s last namestring
email_addrThe user’s emailstring
roleThe user’s rolestring
departmentThe user’s departmentstring
manager_emailThe user’s manager emailstring
full_nameThe user’s full namestring
employee_idThe user’s employee IDstring
cost_center_idThe user’s cost center IDstring
cost_center_nameThe user’s cost center namestring
work_statusThe user’s work statusenum
country_codeThe user’s country codestring
timezoneThe user’s timezonestring
regionThe user’s regionstring
cityThe user’s citystring
stateThe user’s statestring
user_tagsThe user’s assigned user tagsenum
external_system_identitiesThe user’s system related infomap

Any key value pair that does not match up with one of the default user attributes can be mapped to the custom_attributes field

For example, if you a have a field called office that would like to map to the Moveworks User, you would map that under custom_attributes, and can then access the field using user.custom_attributes.office

work_status enum

The work status field is composed of the following predefined options

options
UNKNOWN_WORK_STATUS
CONTINGENT
INTERN
FULL_TIME

user_tags enum

The user tags field is composed of the following predefined options:

options
UNKNOWN_USER_TAG
BASIC_USER
VIP
FIELD_AGENT
KNOWLEDGE_WORKER
IT_AGENT
TESTER
SUPPORTED_LANGUAGE_USER
SERVICE_ACCOUNT
CALL_CENTER
HAS_ACCESS_TO_BOT
DIRECTOR
EXECUTIVE
SOCIAL_AUTH_USER

external_system_identities map

The external system identities map has the shape of <string, ExternalSystemIdentity> which can be interpreted as a dictionary with a string key such as jira_service_desk and an object as its value. The objects composes of the following fields:

An example mapping would be: user.external_system_identities.jira_service_desk.external_id

fieldsdescription
user_idThe user ID to log into the external system
external_idThe user UUID in the external system

Refer to this article to learn about registering a custom user attribute.

Example & Schema

{
  "user": {
    "custom_attributes": {
      "office_location": "Building 4, Floor 12",
      "primary_skill": "Network troubleshooting"
    },
    "first_name": "Jane",
    "last_name": "Doe",
    "email_addr": "jane.doe@example.com",
    "role": "Senior IT Agent",
    "department": "Global IT",
    "manager_email": "manager.smith@example.com",
    "full_name": "Jane Doe",
    "employee_id": "987654",
    "cost_center_id": "IT-456-US",
    "cost_center_name": "US IT Operations",
    "work_status": "FULL_TIME",
    "country_code": "US",
    "timezone": "America/New_York",
    "region": "NA-East",
    "city": "New York",
    "state": "NY",
    "user_tags": ["VIP", "IT_AGENT", "HAS_ACCESS_TO_BOT"],
    "external_system_identities": {
      "jira_service_desk": {
        "user_id": "janedoe_jira",
        "external_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8"
      },
      "workday": {
        "user_id": "987654",
        "external_id": "o9p8q7r6-s5t4-3210-u1v2-w3x4y5z6a7b8"
      }
    }
  }
}
Schema
{
  "user": {
    "custom_attributes": {
      "type": "obj",
      "description": "This can be used to dot walk into custom attributes"
    },
    "first_name": {
      "type": "string",
      "description": "The user's first name"
    },
    "last_name": {
      "type": "string",
      "description": "The user's last name"
    },
    "email_addr": {
      "type": "string",
      "description": "The user's email"
    },
    "role": {
      "type": "string",
      "description": "The user's role"
    },
    "department": {
      "type": "string",
      "description": "The user's department"
    },
    "manager_email": {
      "type": "string",
      "description": "The user's manager email"
    },
    "full_name": {
      "type": "string",
      "description": "The user's full name"
    },
    "employee_id": {
      "type": "string",
      "description": "The user's employee ID"
    },
    "cost_center_id": {
      "type": "string",
      "description": "The user's cost center ID"
    },
    "cost_center_name": {
      "type": "string",
      "description": "The user's cost center name"
    },
    "work_status": {
      "type": "enum",
      "description": "The user's work status",
      "options": [
        "UNKNOWN_WORK_STATUS",
        "CONTINGENT",
        "INTERN",
        "FULL_TIME"
      ]
    },
    "country_code": {
      "type": "string",
      "description": "The user's country code"
    },
    "timezone": {
      "type": "string",
      "description": "The user's timezone"
    },
    "region": {
      "type": "string",
      "description": "The user's region"
    },
    "city": {
      "type": "string",
      "description": "The user's city"
    },
    "state": {
      "type": "string",
      "description": "The user's state"
    },
    "user_tags": {
      "type": "enum",
      "description": "The user's assigned user tags",
      "options": [
        "UNKNOWN_USER_TAG",
        "BASIC_USER",
        "VIP",
        "FIELD_AGENT",
        "KNOWLEDGE_WORKER",
        "IT_AGENT",
        "TESTER",
        "SUPPORTED_LANGUAGE_USER",
        "SERVICE_ACCOUNT",
        "CALL_CENTER",
        "HAS_ACCESS_TO_BOT",
        "DIRECTOR",
        "EXECUTIVE",
        "SOCIAL_AUTH_USER"
      ]
    },
    "external_system_identities": {
      "type": "map",
      "description": "The user's system related info",
      "structure": {
        "shape": "<string, ExternalSystemIdentity>",
        "value_object_fields": {
          "user_id": {
            "description": "The user ID to log into the external system"
          },
          "external_id": {
            "description": "The user UUID in the external system"
          }
        },
        "example_mapping": "user.external_system_identities.jira_service_desk.external_id"
      }
    }
  }
}