serviceLevelAgreementCreate Mutation

Creates a new service level agreement.

Input Argument

serviceLevelAgreementCreate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

activityID (ActivityIDInput)

The Activity ID is the unique identifier by which an activity that is performed in the context of a service offering is known in the billing system of the service provider. This contains the activityIDs related to request categories.

agreementID (String)

The Agreement ID is the unique identifier by which all the activities that are performed through the coverage of the SLA are known in the billing system of the service provider.

clientMutationId (String)

A unique identifier for the client performing the mutation.

coverage (SlaCoverage)

Used to specify how people who are to be covered by the service level agreement are to be selected.

customerAccountId (String)

Identifier of the account which service level managers are allowed to update the parts of the SLA that are intended to be maintained by the service level managers of the customer. More importantly, this field is used to specify whether specialists of the customer are allowed to see the requests that include this SLA in their Affected SLAs section.

customerId (ID!)

Identifier of the organization that pays for the service level agreement.

customerRepresentativeId (ID)

DEPRECATED: use "customerRepresentativeIds" instead

customerRepresentativeIds ([ID!])

Identifiers of the people who represents the customer organization for the service level agreement.

expiryDate (ISO8601Date)

The date through which the service level agreement (SLA) will be active. The SLA expires at the end of this day if it is not renewed before then. When the SLA has expired, its status will automatically be set to "Expired".

name (String!)

The name of the service level agreement.

newEffortClassRateIDs ([EffortClassRateIDInput!])

The Rate IDs are the unique identifiers by which an effort class that is linked to a time entry when an activity was performed through the coverage of the SLA is known in the billing system of the service provider.

newStandardServiceRequestActivityIDs ([StandardServiceRequestActivityIDInput!])

Represents the activityIDs for standard service requests. The Activity ID is the unique identifier by which an activity that is performed in the context of a service offering is known in the billing system of the service provider

noticeDate (ISO8601Date)

The last day on which the service provider organization can still be contacted to terminate the service level agreement (SLA) to ensure that it expires on the intended expiry date. The Notice date field is left empty, and the Expiry date field is filled out, when the SLA is to expire on a specific date and no notice needs to be given to terminate it.

organizationIds ([ID!])

Identifiers of the organizations of the service level agreement. Only available for service level agreements where the coverage field is set to organizations_and_descendants, organizations or organizations_and_sites.

personIds ([ID!])

Identifiers of the people of the service level agreement. Only available for service level agreements where the coverage field is set to people.

remarks (String)

Any additional information about the service level agreement that might prove useful.

remarksAttachments ([AttachmentInput!])

The attachments used in the remarks field.

serviceInstanceId (ID)

Identifier of the service instance that will be used to provide the service to the customer of the service level agreement. Only service instances that are linked to the same service as the selected service offering can be selected.

serviceLevelManagerId (ID)

Identifier of the person of the service provider organization who acts as the service level manager for the customer of the service level agreement.

serviceOfferingId (ID!)

Identifier of the service offering that specifies the conditions that apply to the service level agreement.

siteIds ([ID!])

Identifiers of the sites of the service level agreement. Only available for service level agreements where the coverage field is set to sites or organizations_and_sites.

skillPoolIds ([ID!])

Identifiers of the skill pools of the service level agreement. Only available for service level agreements where the coverage field is set to skill_pools.

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.

startDate (ISO8601Date)

The first day during which the service level agreement (SLA) is active.

status (AgreementStatus)

The current status of the service level agreement (SLA).

useKnowledgeFromServiceProvider (Boolean)

Whether knowledge articles from the service provider should be exposed to the people covered by the service instances related to the service level agreement. Only available for service level agreements where the coverage field is set to service_instances.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

serviceLevelAgreement (ServiceLevelAgreement)

Record after mutation.