Person Object

Root Connection

All Person objects of an account are accessible by a query on the root connection people. Such a query will return a PersonConnection!, which contains the Person objects in its nodes field.

people (PersonConnection!)

Root connection for retrieving Person records.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
filter PersonFilter

Filter to determine which Person records are returned.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
order [PersonOrder!]

Order of the Person records returned.
view PersonView

View name.

The default value is current_account.

Fields

The fields in this section list which values can be retrieved when querying Person records.

account (Account)

The account this record belongs to.

authenticationID (String)

Uniquely identify the user for Single Sign-On

autoTranslation (Boolean)

Whether the person should be offered translations for texts that are written in languages other than the ones selected in the Language (language) and the Do not translate (do_not_translate_languages) fields. Such texts are translated automatically into the language selected in the Language (language) field.

costPerHour (MonetaryAmount)

The person's estimated total cost per work hour for the service provider organization. The value in this field should include the costs of the person's salary (or rate in case of a long-term contractor), office space, service subscriptions, training, etc.

costPerHourCurrency (Currency)

The currency of the cost per hour value of this skill pool.

createdAt (ISO8601Timestamp)

The date and time at which the record was created.

customFields ([CustomField!])

Values of custom fields.

disabled (Boolean)

true when the person may no longer be related to other records.

doNotTranslateLanguages ([String!])

The languages that should not be translated automatically for the person. Translations will not be offered to the person for texts in any of these languages. This field can contain a comma-separated list of language codes. Supported language codes are: en, nl, de, fr, es, pt, it, da, fi, sv, pl, cs, tr, ru, ar, id, fa, no, zh, ja, ko, he, hi, ms.

employeeID (String)

The unique identifier for a person typically based on order of hire or association with an organization.

excludeTeamNotifications (Boolean)

Whether team notifications should be excluded from all notifications.

guest (Boolean)

true when the person registered as a guest in self service.

id (ID!)

Unique identifier of the record.

information (String)

Any additional information about the person that might prove useful.

jobTitle (String)

The person's job title.

language (Language)

The language preference of the person.

lifeCycleState (LifeCycleState)

Current state of the record.

location (String)

The name or number of the room, cubicle or area where the person has his/her primary work space.

manager (Person)

The manager or supervisor to whom the person reports.

name (String)

The person's name.

oauthPersonEnablement (Boolean)

An enabled OAuth person is mentionable and visible in suggest fields, just like a real person.

organization (Organization)

The organization for which the person works as an employee or long-term contractor.

pictureUri (String)

The hyperlink to the image file for the record.

primaryEmail (String)

The email address to which email notifications are to be sent. This email address acts as the unique identifier for the person within the R-Service account. This primary email address also acts as the person's login name if he/she is a user of the R-Service service.

sendEmailNotifications (PersonSendEmailNotifications)

Indicates when to send email notifications to the person.

showNotificationPopup (PersonShowNotificationPopup)

Indicates when to show a notification popup to the person.

site (Site)

Where the person is stationed.

source (String)

An identifier for the client application submitting the resource or the name of an external system.

sourceID (String)

The unique identifier of the resource in an external system.

supportID (String)

A number or code that a service desk analyst can ask the person for when the person contacts the service desk for support.

timeFormat24h (Boolean)

Whether the person prefers to see times displayed within the R-Service service in the 24-hour format or not (in which case the 12-hour format is applied).

timeZone (TimeZone)

The time zone in which the person normally resides.

uiExtension (UiExtension)

UI extension that is linked to the record.

updatedAt (ISO8601Timestamp)

The date and time of the last update of the record. If the record has no updates it contains the createdAt value.

vip (Boolean)

Whether the person is a very important person.

workHours (Calendar)

Calendar that represents the work hours of the person.

Connections

The connection fields in this section allow (paged) access to objects related to a specific Person record. The actual objects will be in the nodes field of the connection.

addresses (AddressConnection)

Addresses of the record.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
cart (ShopOrderLineConnection)

The shop order lines related to this person with status in_cart.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
configurationItems (ConfigurationItemConnection)

Configuration items this person is related to as a user.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
contacts (ContactConnection)

Contact details for this entity.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
customFieldsAttachments (AttachmentConnection)

Inline images linked to one of the custom fields.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
informationAttachments (AttachmentConnection)

Files and inline images linked to the Information field.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
outOfOfficePeriods (OutOfOfficePeriodConnection)

Out of office periods for this person.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
permissions (PermissionConnection)

Permissions of this person.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
skillPools (SkillPoolConnection)

Skill pools this person belongs to.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.
teams (TeamConnection)

Teams this person belongs to.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.
before String

Returns the elements in the list that come before the specified cursor.
first Int

Returns the first n elements from the list.
last Int

Returns the last n elements from the list.

Implements

Person implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a Person.