Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Mutations

Overview

Objects

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. Example: "SampleOrg12345"

accountName
String

Name of the account

accountType
String!,non-null

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

contactEmail
String

Email address of the Contact in the account. Example: "Joe@example.com"

partnerTierName
String!,non-null

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

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

AttributeInput

Represents a custom attributes. Mandatory custom attributes must be provided for the request to be successful

name
String!,non-null

Name of the custom attribute. Example: "REGION"

value
JSON!,non-null

Value assigned to the custom attribute. Format and example depend on the type:

  • Single Text: "EMEA"
  • Multi-valued text: provide list of values between brackets [] delimited by , (e.g. ["Text1", "Text2"])
  • Date: "YYYY/MM/DD" (e.g. "2025/12/31")
  • Number: 12345
Sample
{ "name": "Example String", "value": "Example Custom Scalar" }

AttributesInput

Attributes input for custom attributes.

name
String

Attribute name. Example: "ca_text"

value

Attribute value (can be text/number/boolean/multiselect/date). Example: "testing"

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

AttributeUpdateInput

Represents an update to a custom attribute

name
String!,non-null

Name of the custom attribute

type
String!,non-null

Type of the custom attribute. It can be of LINE_ITEM or LICENSE_MODEL

value
String!,non-null

Value assigned to the custom attribute. If the value is of type Date, then it should use yyyy/MM/dd format. Similarly, appropriate value corresponding to the type of custom attribute must be provided

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

CreateAccountInput

Input for creating an account

accountId
String!,non-null

Unique identifier of the account (short account name). Example: "12345"

accountType
String!,non-null

Defines the account type. Valid values: CUSTOMER, PUBLISHER, CHANNEL_PARTNER. Default: CUSTOMER. (Using GraphQL, a new account cannot be created with an accountType of SELF_REGISTERED) Example: "CUSTOMER"

address1
String

First line of account's address. Example: "123 Flexera St"

address2
String

Second line of account's address. Example: "Suite 100"

List of custom attributes attached to this account. Note that mandatory custom attributes must be included in this list

city
String

City portion of account's address. Example: "Chicago"

country
String

Two-letter country code. Example: "US"

description
String

Description of the account. Example: "Flexera Software LLC - Main Office"

name
String!,non-null

Display name of the account (full account name). Example: "Flexera Software LLC"

region
String

Region in which this account's address exists. Example: "North America"

state
String

State portion of account's address. Example: "IL"

visible
Boolean
Default:true

Applicable to CUSTOMER and CHANNEL_PARTNER accounts, visible determines whether or not an account unrelated to this account can see the name of this account when it is in a channel partner tier of an entitlement, line item, or device. If visible is false, this account will appear as Name Withheld to unrelated accounts. Default: true. Example: true

zipcode
String

Zip/Postal code of the account's address. Example: "60601"

Sample
{ "accountId": "Example String", "accountType": "Example String", "address1": "Example String", "address2": "Example String", "attributes": [ { "__typename": "AttributeInput" } ], "city": "Example String", "country": "Example String", "description": "Example String", "name": "Example String", "region": "Example String", "state": "Example String", "visible": true, "zipcode": "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. Example: false

description
String

Description of the entitlement. Example: "Description for entitlement"

emailTemplateVariation
String

Name of the email template to be used for entitlement related emails. Example: "DEFAULT"

entitlementId
String

Entitlement ID of the entitlement. If you specify the entitlement ID, then it must be unique across all entitlements and line items. If you specify the entitlement ID here, then the autoGenerate flag must be set to false. Example: "ent-id-1234"

List of line items contained in the entitlement

shipToAddress
String

Address of the ship-to contact. Example: "Building-Street-City"

shipToEmail
String

Email address of the ship-to contact. Example: "Joe@example.com"

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

CreateFeatureBundleInput

Input for creating a feature bundle

autoDeploy
Boolean

Auto Deploy flag to indicate whether the feature bundle should be deployed or not. If true, the feature bundle will be automatically deployed after creation.

description
String

Describe the characteristics of this feature bundle that make it unique. Example: "This feature bundle enables advanced reporting."

featureBundleName
String!,non-null

Name to uniquely identify the feature bundle. Must contain only ASCII letters, numbers, or _ (underscore) with no whitespace. Maximum length: 64 characters. Example: "MyFeatureBundle"

Optional feature list for the feature bundle.

Sample
{ "autoDeploy": true, "description": "Example String", "featureBundleName": "Example String", "featureList": [ { "__typename": "FeatureBundleFeatureInput" } ] }

CreateFeatureInput

Input for creating a feature

aggregationType
String

Select an Aggregation Type for the feature. Valid values: NONE, SUM, MAX. Example: "SUM"

autoDeploy
Boolean

Auto Deploy flag to indicate whether the feature should be deployed or not. If true, the feature will be automatically deployed after creation.

description
String

Describe the characteristics of this feature that make it unique. Maximum length: 2000 characters. Example: "This feature enables advanced reporting."

featureName
String!,non-null

Name to uniquely identify the feature. Must contain only ASCII letters, numbers, or _ (underscore) with no whitespace. Maximum length: 64 characters. Example: "MyFeature"

featureOverrideParams

Optional override parameters for the feature.

maxVersion
String

Specify maxVersion of the feature. Format: yyyy.MMdd, yyyy.MM.dd, or yyyy.MM . Example: "2023.10.15"

version
String

If a FIXED version format is selected, specify version of the feature. Must not contain whitespace characters. Maximum length: 64 characters. Example: "1.0"

versionFormat
String!,non-null

Select a FIXED or DATEBASED version format. Valid values: FIXED, DATEBASED. Example: "FIXED"

Sample
{ "aggregationType": "Example String", "autoDeploy": true, "description": "Example String", "featureName": "Example String", "featureOverrideParams": { "__typename": "FeatureOverrideParamsInput" }, "maxVersion": "Example String", "version": "Example String", "versionFormat": "Example String" }

CreateLineItemInput

Input to create a new line item

lineItems

List of line item input objects

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

CreateMaintenanceProductInput

Input for creating a maintenance product.

allowRenewals
Boolean

Allow renewals flag to indicate whether the maintenance product can be renewed. Example: true

allowUpgrades
Boolean

Allow upgrades flag to indicate whether the maintenance product can be upgraded. Example: true

allowUpsells
Boolean

Allow upsells flag to indicate whether the maintenance product can be upsold. Example: true

description
String

Description of the maintenance product. Example: "This maintenance product is for advanced maintenance."

maintenanceName
String!,non-null

Name to uniquely identify the maintenance product. Can only contain ASCII letters, numbers, or _ (underscore) with no whitespace. Maximum length: 64 characters. Example: "MyMaintenanceProduct"

Optional part number list for the maintenance product.

productLine
String

Maintenance product product line. Example: "Uncategorized Products"

Optional product list for the maintenance product.

version
String!,non-null

Maintenance product version. Maximum length: 64 characters. Example: "1.0"

Sample
{ "allowRenewals": true, "allowUpgrades": true, "allowUpsells": true, "description": "Example String", "maintenanceName": "Example String", "partNumberList": [ { "__typename": "MaintenanceProductPartNumberInput" } ], "productLine": "Example String", "productList": [ { "__typename": "MaintenanceProductProductInput" } ], "version": "Example String" }

CreatePartNumberInput

Input for creating part numbers

partNumbers

List of part numbers to create. Must not be empty.

Sample
{ "partNumbers": [ { "__typename": "PartNumberInput" } ] }

Scalars

Overview