Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Mutations

Overview

Objects

Overview

Enums

Overview

Inputs

Overview

AccountInput

Represents an Account

CurrentOwner
Boolean

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

accountId
String!,non-null

ID of the account

accountName
String

The name of the account

accountType
AccountType!,non-null

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

contactEmail
String

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" }

AttributeInput

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" }

AttributeUpdateInput

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" }

CreateEntitlementInput

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
Boolean

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
Boolean

Flag to indicate if the entitlement should be auto-deployed

autoGenerate
Boolean

Whether the entitlement ID is to be auto-generated.

description
String

Description of the entitlement

emailTemplateVariation
String

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

entitlementId
String

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
String

Address of the ship-to contact

shipToEmail
String

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" }

CreateLineItemInput

Input to create a new line item

lineItems

List of line item input objects

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

LicenseModelInput

Represents a License Model

issuer
String

specify who is issuing the license

licenseModelName
String!,non-null

specify a name that uniquely identifies this license model

notice
String

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

serialNumber
String

specify the serial number of the license

vendorString
String

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" }

LineItemInput

Represents a line item in the entitlement

activatable
Boolean

Flag to indicate whether this line item is activatable

activationId
String

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
Boolean

Whether the Line item should be auto-deployed

autoGenerate
Boolean

Whether the activation ID should be auto-generated

expiryDate
String

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
Boolean

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

List of products entitled by this line item

quantity
Int

Number of copies for the entitlement

quantityPerCopy
Int

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" }

LineItemPropertyInput

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
Boolean

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
String

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" } }