Skip to content
Overview
Overview
Overview
Overview
Overview
Overview

Represents an Account

CurrentOwner

Whether this account is the current owner of the entitlement in the distribution chain

accountId
String!,non-null

ID of the account

accountName

The name of the account

accountType
AccountType!,non-null

Type of the account. Valid types are PUBLISHER, CUSTOMER, CHANNEL_PARTNER, SELF_REGISTERED, UNKNOWN

contactEmail

Email address of the Contact in the account

partnerTierName
PartnerTier!,non-null

Partner tier of the account owning the entitlement. Valid values are END_CUSTOMER and PARTNER_TIER_ONE

Sample
{ "CurrentOwner": true, "accountId": "Example String", "accountName": "Example String", "accountType": "CHANNEL_PARTNER", "contactEmail": "Example String", "partnerTierName": "END_CUSTOMER" }

Represents a Custom Attribute

name
String!,non-null

Name of the custom attribute

value
String!,non-null

The value of the custom attribute. If the value is a date-type, use format yyyy/MM/dd

Sample
{ "name": "Example String", "value": "Example String" }

Represents an update to a custom attribute

name
String!,non-null

Name of the custom attribute to be updated

type
value
String!,non-null

Value of the custom attribute

Sample
{ "name": "Example String", "type": "LICENSE_MODEL", "value": "Example String" }

Input to create an entitlement

List of accounts associated with the entitlement. If account is not provided, the entitlement will be associated with UNKNOWN_ORG_UNIT(default account).

allowPortalLogin

Whether the customer can use the entitlement ID to log into the End-User Portal after the entitlement is deployed

List of entitlement custom attributes. Note that mandatory custom attributes must be included in this list

autoDeploy

Flag to indicate if the entitlement should be auto-deployed

autoGenerate

Whether the entitlement ID is to be auto-generated.

description

Description of the entitlement

emailTemplateVariation

Name of the email template to be used for entitlement related emails

entitlementId

The ID of the entitlement. This is to be specified if you want to generate the entitlement ID yourselves. This means that the autoGenerate flag below is set to false. If the ID matches that of an existing entitlement or line item, then operation will fail.

List of line items contained in the entitlement

shipToAddress

Address of the ship-to contact

shipToEmail

Email address of the ship-to contact

Sample
{ "accounts": [ { "__typename": "AccountInput" } ], "allowPortalLogin": true, "attributes": [ { "__typename": "AttributeInput" } ], "autoDeploy": true, "autoGenerate": true, "description": "Example String", "emailTemplateVariation": "Example String", "entitlementId": "Example String", "lineItems": [ { "__typename": "LineItemInput" } ], "shipToAddress": "Example String", "shipToEmail": "Example String" }

Input to create a new line item

lineItems

List of line item input objects

Sample
{ "lineItems": [ { "__typename": "LineItemInput" } ] }

Represents a License Model

issuer

specify who is issuing the license

licenseModelName
String!,non-null

specify a name that uniquely identifies this license model

notice

This field is usually set at entitlement time and includes customer name and purchase order

serialNumber

specify the serial number of the license

vendorString

Unique value assigned by each publisher to each license

Sample
{ "issuer": "Example String", "licenseModelName": "Example String", "notice": "Example String", "serialNumber": "Example String", "vendorString": "Example String" }

Represents a line item in the entitlement

activatable

Flag to indicate whether this line item is activatable

activationId

The activation ID associated with the line item. You may specify this while creation. If you choose to specify this then the autoGenerate flag should be set to false. If the activationID specified, matches with any existing entitlementID or activationID, then you will get an error

List of custom attributes related to the line item

autoDeploy

Whether the Line item should be auto-deployed

autoGenerate

Whether the activation ID should be auto-generated

expiryDate

End date of the line item in YYYY-MM-DD format

Default:"NEW_ORDER"

Type of order for the line item. The default is NEW_ORDER

permanent

Whether this line item is permanent. A permanent line item has no expiration date.

List of products entitled by this line item

quantity

Number of copies for the entitlement

quantityPerCopy

Quantity per copy. Minimum value is 1

startDate
String!,non-null

Start date of the line item in YYYY-MM-DD format

Sample
{ "activatable": true, "activationId": "Example String", "attributes": [ { "__typename": "AttributeInput" } ], "autoDeploy": true, "autoGenerate": true, "expiryDate": "Example String", "orderType": "INVALID_ORDER", "permanent": true, "product": [ { "__typename": "ProductInput" } ], "quantity": 40, "quantityPerCopy": 40, "startDate": "Example String" }

Represents the properties of a line item that can be updated

activationId
String!,non-null

Activation ID of the line item for which attributes has to be updated.

List of custom attributes related to the line item and license model

deploy

Whether the line item is to be deployed or not. This is used to update the deployment status of the line item

Order type can have values like 'New_Order', 'Renewal_Order', 'Upgrade_Order' and Upsell_Order This is used to identify the type of order for the line item.

parentActivationId

Parent Line Item Activation ID. This is used to update the parent line item when the line item is a child of another line item.

Product related to the line item

Sample
{ "activationId": "Example String", "attributes": [ { "__typename": "AttributeUpdateInput" } ], "deploy": true, "orderType": "INVALID_ORDER", "parentActivationId": "Example String", "product": { "__typename": "UpdateProductInput" } }
activationId

Activation ID of the maintenance line item. If you specify the activation ID, then it must be unique across all entitlements and maintenance line items. If you specify the activation ID here, then the autoGenerate flag must be set to false

List of custom attributes related to the maintenance line item

autoDeploy

Whether the maintenance Line item should be auto-deployed

autoGenerate

Whether the activation ID should be auto-generated

expiryDate

End date of the maintenance line item in YYYY-MM-DD format

maintenanceProduct

List of products entitled by this maintenance line item

permanent

Whether this maintenance line item is permanent. A permanent maintenance line item has no expiration date.

startDate
String!,non-null

Start date of the maintenance line item in YYYY-MM-DD format

Sample
{ "activationId": "Example String", "attributes": [ { "__typename": "AttributeInput" } ], "autoDeploy": true, "autoGenerate": true, "expiryDate": "Example String", "maintenanceProduct": { "__typename": "MaintenanceProductInput" }, "permanent": true, "startDate": "Example String" }
maintenanceProductName

Name of the maintenance product

maintenanceProductVersion

Version of the maintenance product

partNumber

Part number associated with maintenance product

Sample
{ "maintenanceProductName": "Example String", "maintenanceProductVersion": "Example String", "partNumber": "Example String" }