Update a user

UserUpdateResponse autoScribe().users().update(, )

PATCH/v1/autoScribe/users/{userId}

Updates a user's profile information, permissions, and AutoScribe-specific settings. All fields are optional - only provided fields will be updated. Email cannot be changed via API. NPI number is required if enabling report creation capability.

ParametersExpand Collapse

UserUpdateParams params

Optional<String> userId

Unique user identifier. Format: usr_{32-hex-chars}

Optional<Boolean> canCreateReports

Optional<Boolean> canManageStudies

Optional<ClinicRole> clinicRole

A user's clinical or organizational role within the clinic.

Optional<String> firstName

User's first name

minLength1

Optional<Boolean> hasDashboardAccess

Whether the user can access the dashboard interface. Required for admin users

Optional<String> lastName

User's last name

minLength1

Optional<AssignableUserLevel> level

User access level assignable via the API. 'admin' can manage users/settings, 'member' has standard access. 'owner' is dashboard-only and cannot be assigned via the API.

Optional<String> middleName

minLength1

Optional<String> npiNumber

minLength10

maxLength10

Optional<String> phoneNumber

Optional<String> suffix1

minLength1

Optional<String> suffix2

minLength1

ReturnsExpand Collapse

class UserUpdateResponse:

A user in the AutoScribe system with report creation permissions

boolean canCreateReports

Whether the user can generate and sign radiology reports. Requires NPI number

boolean canManageStudies

Whether the user has permission to create, update, and manage studies

ClinicRole clinicRole

A user's clinical or organizational role within the clinic.

Accepts one of the following:

DOCTOR("Doctor")

PHYSICIAN("Physician")

SURGEON("Surgeon")

RADIOLOGIST("Radiologist")

CARDIOLOGIST("Cardiologist")

NEUROLOGIST("Neurologist")

UROLOGIST("Urologist")

GYNECOLOGIST("Gynecologist")

ENDOCRINOLOGIST("Endocrinologist")

ONCOLOGIST("Oncologist")

RADIATION_ONCOLOGIST("Radiation Oncologist")

HEMATOLOGIST("Hematologist")

GASTROENTEROLOGIST("Gastroenterologist")

PULMONOLOGIST("Pulmonologist")

NEPHROLOGIST("Nephrologist")

RHEUMATOLOGIST("Rheumatologist")

DERMATOLOGIST("Dermatologist")

OPHTHALMOLOGIST("Ophthalmologist")

OTOLARYNGOLOGIST("Otolaryngologist")

PEDIATRICIAN("Pediatrician")

OBSTETRICIAN("Obstetrician")

PSYCHIATRIST("Psychiatrist")

ANESTHESIOLOGIST("Anesthesiologist")

EMERGENCY_MEDICINE_PHYSICIAN("Emergency Medicine Physician")

FAMILY_MEDICINE_PHYSICIAN("Family Medicine Physician")

INTERNAL_MEDICINE_PHYSICIAN("Internal Medicine Physician")

PATHOLOGIST("Pathologist")

NUCLEAR_MEDICINE_PHYSICIAN("Nuclear Medicine Physician")

PAIN_MANAGEMENT_SPECIALIST("Pain Management Specialist")

INFECTIOUS_DISEASE_SPECIALIST("Infectious Disease Specialist")

IMMUNOLOGIST("Immunologist")

PHYSICIAN_ASSISTANT("Physician Assistant")

NURSE_PRACTITIONER("Nurse Practitioner")

CERTIFIED_REGISTERED_NURSE_ANESTHETIST("Certified Registered Nurse Anesthetist")

PSYCHOLOGIST("Psychologist")

MEDICAL_ASSISTANT("Medical Assistant")

SCRIBE("Scribe")

REGISTERED_NURSE("Registered Nurse")

NURSE_MANAGER("Nurse Manager")

PATIENT_CARE_COORDINATOR("Patient Care Coordinator")

IMAGING_TECHNOLOGIST("Imaging Technologist")

LABORATORY_TECHNICIAN("Laboratory Technician")

MEDICAL_LABORATORY_SCIENTIST("Medical Laboratory Scientist")

PATHOLOGISTS_ASSISTANT("Pathologists' Assistant")

PHLEBOTOMIST("Phlebotomist")

PHARMACIST("Pharmacist")

PHARMACY_TECHNICIAN("Pharmacy Technician")

PHYSICAL_THERAPIST("Physical Therapist")

OCCUPATIONAL_THERAPIST("Occupational Therapist")

SPEECH_LANGUAGE_PATHOLOGIST("Speech-Language Pathologist")

RESPIRATORY_THERAPIST("Respiratory Therapist")

NUTRITIONIST("Nutritionist")

FRONT_DESK_OPERATOR("Front Desk Operator")

REVENUE_CYCLE_MANAGER("Revenue Cycle Manager")

ADMINISTRATIVE_DIRECTOR("Administrative Director")

ADMINISTRATIVE_ASSISTANT("Administrative Assistant")

LEGAL_ADMINISTRATOR("Legal Administrator")

IT_ADMINISTRATOR("IT Administrator")

IT_SUPPORT("IT Support")

SOFTWARE_ENGINEER("Software Engineer")

OTHER("Other")

Optional<LocalDateTime> createdAt

Timestamp when the user was created

formatdate-time

String email

User's email address for login and notifications

String firstName

User's first name

minLength1

boolean hasDashboardAccess

Whether the user can access the dashboard interface. Required for admin users

InvitedSource invitedSource

How a user/invitation was created - via the dashboard UI ('dashboard') or the API ('api').

Accepts one of the following:

DASHBOARD("dashboard")

API("api")

Optional<LocalDateTime> lastLoginAt

Timestamp of user's last login, null if never logged in

formatdate-time

String lastName

User's last name

minLength1

UserLevel level

User access level. 'owner' has full control (dashboard-only, not assignable via API), 'admin' can manage users/settings, 'member' has standard access.

Accepts one of the following:

OWNER("owner")

ADMIN("admin")

MEMBER("member")

String userId

Unique user identifier. Format: usr_{32-hex-chars}

Optional<String> middleName

User's middle name (optional)

minLength1

Optional<String> npiNumber

National Provider Identifier - required for users who can create reports (10-digit number)

minLength10

maxLength10

Optional<String> phoneNumber

User's phone number (10-15 digits, optional)

Optional<String> suffix1

Name suffix (e.g., 'Jr.', 'Sr.', 'III') - optional

minLength1

Optional<String> suffix2

Additional name suffix (optional)

minLength1

Update a user

package com.avara.example;

import com.avara.client.AvaraClient;
import com.avara.client.okhttp.AvaraOkHttpClient;
import com.avara.models.autoscribe.users.UserUpdateParams;
import com.avara.models.autoscribe.users.UserUpdateResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        AvaraClient client = AvaraOkHttpClient.fromEnv();

        UserUpdateResponse user = client.autoScribe().users().update("usr_1234567890abcdef1234567890abcdef");
    }
}

{
  "canCreateReports": true,
  "canManageStudies": true,
  "clinicRole": "Radiologist",
  "createdAt": "2024-01-15T10:00:00Z",
  "email": "dr.johnson@hospital.org",
  "firstName": "Sarah",
  "hasDashboardAccess": true,
  "invitedSource": "api",
  "lastLoginAt": "2024-03-15T09:00:00Z",
  "lastName": "Johnson",
  "level": "member",
  "userId": "usr_1234567890abcdef1234567890abcdef",
  "middleName": "Marie",
  "npiNumber": "1234567893",
  "phoneNumber": "5551234567",
  "suffix1": "MD",
  "suffix2": "FACR"
}

Returns Examples

{
  "canCreateReports": true,
  "canManageStudies": true,
  "clinicRole": "Radiologist",
  "createdAt": "2024-01-15T10:00:00Z",
  "email": "dr.johnson@hospital.org",
  "firstName": "Sarah",
  "hasDashboardAccess": true,
  "invitedSource": "api",
  "lastLoginAt": "2024-03-15T09:00:00Z",
  "lastName": "Johnson",
  "level": "member",
  "userId": "usr_1234567890abcdef1234567890abcdef",
  "middleName": "Marie",
  "npiNumber": "1234567893",
  "phoneNumber": "5551234567",
  "suffix1": "MD",
  "suffix2": "FACR"
}