A user is an identity with a set of privileges used to access a portal.

Working with users

A user is created when an account is created for a user or when someone signs up to join an organization. When they join, an identity and a role are assigned. A role defines the set of privileges and operations that the user can perform within the organization.

You can also use data management tools and ArcGIS REST API to create and manage users. Only an administrator or the owner of a user's account can make updates to users within an organization.

The typical way to work with users is to:

  1. Invite users or create new users in a portal.
  2. Search for users.
  3. Assign users to groups.
  4. Manage user properties.


The following examples use ArcGIS REST JS to search the ArcGIS Online portal. To access a different portal, specify the portal URL.

Search for a user

Use a query to search users by name, description, and other information.

import { searchItems } from "@esri/arcgis-rest-portal";
// Search for a user wiht text
searchUsers({ q: 'tommy', authentication })
  .then(response) //

Get a user

Find a user with their username.

import { getUser } from '@esri/arcgis-rest-portal';
// Find a user name
// => { firstName: "John", lastName: "Smith",tags: ["GIS Analyst", "City of Redlands"] }

Update user information

Update user profile information such as their role or credits assigned.

import { updateUser } from '@esri/arcgis-rest-portal';
// any user can update their own profile
  user: { description: "better than the last one" }
// org administrators must declare the username that will be updated explicitly
  user: { username: "c@sey", description: "" }
// => { "success": true, "username": "c@sey" }

Get invitation status

Find the status of an invitation that was sent to a user to join a portal.

import { getUserInvitation } from '@esri/arcgis-rest-portal';
// username is inferred from UserSession
  invitationId: "3ef",
  .then(response) // => response.accepted => true