Edit Profile by Admin API

Allow administrators to update any user's profile and account settings

Admin

Edit Profile by Admin API

Update any user's profile and account settings as an administrator. Modify credentials, profile information, and reseller assignments.

Full Access

Edit any user's profile.

Credentials

Update passwords and emails.

Reseller Link

Change reseller assignment.


Endpoint Overview

MUTATION/graphql

Update a user's account settings and profile information as an administrator. Can modify email, password, reseller ID, and all profile fields.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

idInt!Required

The unique identifier of the user to update.

updatedUser.emailString

New email address for the user.

updatedUser.passwordString

New password for the user.

updatedUser.resellerIdInt

New reseller ID to associate with this user.

updatedProfile.firstNameString

User's first name.

updatedProfile.lastNameString

User's last name.

updatedProfile.phoneString

Contact phone number.

updatedProfile.addressString

Street address.

updatedProfile.cityString

City name.

updatedProfile.countryString

Country code.

updatedProfile.postalCodeString

Postal/ZIP code.

updatedProfile.birthDateString

Date of birth (YYYY-MM-DD).


GraphQL Mutation

mutation editProfileByAdmin(
  $id: Int!,
  $updatedUser: UserCreate,
  $updatedProfile: UserProfileEdit
) {
  editProfileByAdmin(
    id: $id,
    updatedUser: $updatedUser,
    updatedProfile: $updatedProfile
  ) {
    success
    message
  }
}

Variables:

{
  "id": 12345,
  "updatedUser": {
    "email": "newemail@example.com",
    "password": "NewSecurePass123!",
    "resellerId": 200
  },
  "updatedProfile": {
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+1987654321",
    "city": "San Francisco",
    "country": "US"
  }
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -d '{
    "query": "mutation editProfileByAdmin($id: Int!, $updatedUser: UserCreate, $updatedProfile: UserProfileEdit) { editProfileByAdmin(id: $id, updatedUser: $updatedUser, updatedProfile: $updatedProfile) { success message } }",
    "variables": {
      "id": 12345,
      "updatedProfile": {
        "firstName": "Jane",
        "lastName": "Smith"
      }
    }
  }'

Response

200Profile Updated Successfully
{
  "data": {
    "editProfileByAdmin": {
      "success": true,
      "message": "Profile updated successfully"
    }
  }
}
400User Not Found
{
  "errors": [
    {
      "message": "User with ID 12345 not found",
      "path": ["editProfileByAdmin"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}

Admin Capabilities

Email Changes

Update user's login email address.

Password Reset

Set new password for user.

Reseller Transfer

Move user between resellers.

Profile Updates

Modify all personal information.


Use Cases

Support Request

Update user info from support ticket.

Account Recovery

Reset credentials for locked out users.

Data Correction

Fix incorrect user information.

Reseller Migration

Transfer users between resellers.



Sensitive Operation

Changing email or password affects user's ability to login. Ensure you have proper authorization and notify the user of credential changes.

View User First?

Look up user details before making changes to their profile.

Get User by ID