hr\_Utils - Scoped

concept australia Updated Sep 10, 2026 1 min read hr_UtilsAPI.md

The hr_Utils API provides basic functionality for the Human Resource (HR) application.

This API requires the HR core plugin (com.sn_hr_core) and runs in the sn_hr_core namespace.

hr_Utils - hr_Utils()

Instantiates an instance of the hr_Utils class.

Name	Type	Description
None

hr_Utils - getPrimaryJob(String userId)

Gets the Sys ID of the active primary job for a provided user.

Name	Type	Description
userID	String	Sys ID of the HR user from the User [sys_user] table assigned an active or future job in which Primary is true.

Type	Description
String	If present and active, Sys ID of the primary job from the Jobs [sn_hr_core_job] table, null otherwise.

JavaScript

var result = new sn_hr_core.hr_Utils().getPrimaryJob('5137153cc611227c000bbd1bd8cd2007');gs.info('Result: ' + result);

Output:

Text

Result: eb3c69463cd63740964fb8b1ce04f9ae

hr_Utils - switchPrimaryJob(String userId String jobId)

Switches the primary job of a user.

Name	Type	Description
userId	String	Sys ID of HR user from the Users [sys_user] table.
jobId	String	Job Sys ID from the Jobs [sn_hr_core_job] table.

Type	Description
String	Encoded JSON with message and status, error otherwise.

JavaScript

var result = new sn_hr_core.hr_Utils().switchPrimaryJob('5137153cc611227c000bbd1bd8cd2007', 'bc884e723c0ebf00964fb8b1ce04f9d7');gs.info('Result: ' + result);

Output:

Text

Result: {"message":"Switched primary job for the user successfully","status":"success"}

78 lines · 2.4 KB Wrap lines

---
title: hr\_Utils - Scoped
description: The hr\_Utils API provides basic functionality for the Human Resource \(HR\) application.Instantiates an instance of the hr\_Utils class.Gets the Sys ID of the active primary job for a provided user.Switches the primary job of a user.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/api-reference/server-api-reference/hr\_UtilsAPI.html
release: australia
product: Server API Reference
classification: server-api-reference
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Server API reference, API reference, API implementation and reference]
---

# hr\_Utils- Scoped

The hr\_Utils API provides basic functionality for the Human Resource \(HR\) application.

This API requires the HR core plugin \(com.sn\_hr\_core\) and runs in the `sn_hr_core` namespace.

**Parent Topic:**[Server API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/api-server.md)

## hr\_Utils - hr\_Utils\(\)

Instantiates an instance of the hr\_Utils class.

|Name|Type|Description|
|----|----|-----------|
|None| | |

## hr\_Utils - getPrimaryJob\(String userId\)

Gets the Sys ID of the active primary job for a provided user.

|Name|Type|Description|
|----|----|-----------|
|userID|String|Sys ID of the HR user from the User \[sys\_user\] table assigned an active or future job in which Primary is true.|

|Type|Description|
|----|-----------|
|String|If present and active, Sys ID of the primary job from the Jobs \[sn\_hr\_core\_job\] table, null otherwise.|

```
var result = new sn_hr_core.hr_Utils().getPrimaryJob('5137153cc611227c000bbd1bd8cd2007');
gs.info('Result: ' + result);
```

Output:

```
Result: eb3c69463cd63740964fb8b1ce04f9ae
```

## hr\_Utils - switchPrimaryJob\(String userId String jobId\)

Switches the primary job of a user.

|Name|Type|Description|
|----|----|-----------|
|userId|String|Sys ID of HR user from the Users \[sys\_user\] table.|
|jobId|String|Job Sys ID from the Jobs \[sn\_hr\_core\_job\] table.|

|Type|Description|
|----|-----------|
|String|Encoded JSON with message and status, error otherwise.|

```
var result = new sn_hr_core.hr_Utils().switchPrimaryJob('5137153cc611227c000bbd1bd8cd2007', 'bc884e723c0ebf00964fb8b1ce04f9d7');
gs.info('Result: ' + result);
```

Output:

```
Result: {"message":"Switched primary job for the user successfully","status":"success"}
```