Sign in

v1

latestOpenAPI 3.1.02026-07-2489171167.4 KB
Agents

Update Agent Details

Update the details of an existing Agent identified by their SysAid ID. The new values provided will overwrite existing values.

patch/agents/{id}

Request body

firstNamestring

The user's first name.

lastNamestring

The user's last name.

displayNamestring

The user's display name

userEmailstring

The user's email address.

isDisabledboolean

Indicates if the user is disabled

companyIdnumber nullable

Unique ID of the company the user works for

departmentIdnumber nullable

Unique ID of the department the user belongs to

locationIdnumber nullable

Unique ID of the location associated with the user

timezonestring

The time zone of the user

languagestring

The language used by the user (default is "en")

workPhonestring

User's work phone number/extension

mobilestring

User's mobile number

receiveSRNotificationsboolean

Enable or disable automatic SR email notifications

enablePortalLoginboolean

Enable login to the End User Portal

managerIdinteger
supervisorLevel'none' | 'department' | 'company'

Enable the user to have access to other's ssp tickets

jobTitlestring nullable

User's job title

permissionType'user' | 'group'

Defines whether the Agent's permissions should be inherited from a group or set directly for this user.

versioninteger required

The version number of the resource used for optimistic locking. This value must be provided when updating a resource to prevent conflicts caused by concurrent modifications. If the provided version does not match the current version on the server, the update will be rejected to ensure data consistency.

Example request

{
  "firstName": "John",
  "lastName": "Doe",
  "displayName": "John Doe",
  "userEmail": "johndoe@sysaid.com",
  "companyId": 342,
  "departmentId": 342,
  "locationId": 342,
  "timezone": "Asia/Jerusalem",
  "language": "en",
  "managerId": 234,
  "supervisorLevel": "department",
  "jobTitle": "Engineering Director",
  "permissionType": "user",
  "version": 13
}

Response

Agent updated successfully

successboolean

Example response

{
  "success": true,
  "agent": {
    "firstName": "John",
    "lastName": "Doe",
    "displayName": "John Doe",
    "userEmail": "johndoe@sysaid.com",
    "companyId": 342,
    "departmentId": 342,
    "locationId": 342,
    "timezone": "Asia/Jerusalem",
    "language": "en",
    "managerId": 234,
    "supervisorLevel": "department",
    "jobTitle": "Engineering Director",
    "permissionType": "user",
    "userName": "johndoe",
    "company": {
      "name": "Alpha",
      "address": "123 Main Street",
      "address2": "Apt. 4B",
      "city": "Washington",
      "state": "Virginia",
      "country": "USA",
      "fax": "555-555-1234",
      "notes": "Some notes about the company.",
      "emailAccount": "company@mail.com",
      "expirationDate": "30-12-2120",
      "agreementId": 5,
      "agreementStartDate": "22-10-2025",
      "agreementEndDate": "01-08-2024",
      "customFields": {
        "company_cust_int_field": 5
      },
      "version": 5,
      "id": 1
    },
    "groups": [
      {
        "name": "IT Support",
        "supportLevel": 3,
        "companyId": 1001,
        "email": "support@example.com",
        "receiveAutomaticSrEmailNotifications": true,
        "canBeAssignedToServiceRecord": true,
        "id": 123
      }
    ],
    "version": 13
  }
}