Licenses
Last updated
Queries
contract query
Retrieve contract data from the Viio GraphQL API.
contract(id: ID!): Contract
Returns: Contract
Arguments for contract
| Name | Description |
|---|---|
id (ID!) |
contracts query
Retrieve contracts data from the Viio GraphQL API.
contracts(first: Int, after: String, last: Int, before: String, where: ContractFilterInput, order: [ContractSortInput!]): ContractsConnection
Returns: ContractsConnection
Arguments for contracts
| Name | Description |
|---|---|
where (ContractFilterInput) | |
order ([ContractSortInput!]) | |
first (Int) | Returns the first n elements from the list. |
after (String) | Returns elements after the specified cursor. |
last (Int) | Returns the last n elements from the list. |
before (String) | Returns elements before the specified cursor. |
licensePlans query
Retrieve licensePlans data from the Viio GraphQL API.
licensePlans(first: Int, after: String, last: Int, before: String, where: LicensePlanFilterInput, order: [LicensePlanSortInput!]): LicensePlansConnection
Returns: LicensePlansConnection
Arguments for licensePlans
| Name | Description |
|---|---|
where (LicensePlanFilterInput) | |
order ([LicensePlanSortInput!]) | |
first (Int) | Returns the first n elements from the list. |
after (String) | Returns elements after the specified cursor. |
last (Int) | Returns the last n elements from the list. |
before (String) | Returns elements before the specified cursor. |
licensePlan query
Retrieve licensePlan data from the Viio GraphQL API.
licensePlan(id: ID!): LicensePlan
Returns: LicensePlan
Arguments for licensePlan
| Name | Description |
|---|---|
id (ID!) |
aggregatedLicensePlans query
Retrieve aggregatedLicensePlans data from the Viio GraphQL API.
aggregatedLicensePlans(groupBy: AggregatedLicensePlansGroupByInput!, first: Int, after: String, last: Int, before: String, where: LicensePlanFilterInput, order: [LicensePlanSortInput!]): AggregatedLicensePlansConnection
Returns: AggregatedLicensePlansConnection
Arguments for aggregatedLicensePlans
| Name | Description |
|---|---|
groupBy (AggregatedLicensePlansGroupByInput!) | |
where (LicensePlanFilterInput) | |
order ([LicensePlanSortInput!]) | |
first (Int) | Returns the first n elements from the list. |
after (String) | Returns elements after the specified cursor. |
last (Int) | Returns the last n elements from the list. |
before (String) | Returns elements before the specified cursor. |
licenses query
Retrieve licenses data from the Viio GraphQL API.
licenses(first: Int, after: String, last: Int, before: String, where: LicenseFilterInput, order: [LicenseSortInput!]): LicensesConnection
Returns: LicensesConnection
Arguments for licenses
| Name | Description |
|---|---|
where (LicenseFilterInput) | |
order ([LicenseSortInput!]) | |
first (Int) | Returns the first n elements from the list. |
after (String) | Returns elements after the specified cursor. |
last (Int) | Returns the last n elements from the list. |
before (String) | Returns elements before the specified cursor. |
licenseAnalytics query
Retrieve licenseAnalytics data from the Viio GraphQL API.
licenseAnalytics(input: LicenseAnalyticsInput!, where: LicenseFilterInput, order: [LicenseAnalyticsBucketSortInput!]): LicenseAnalyticsResult!
Returns: LicenseAnalyticsResult!
Arguments for licenseAnalytics
| Name | Description |
|---|---|
input (LicenseAnalyticsInput!) | |
where (LicenseFilterInput) | |
order ([LicenseAnalyticsBucketSortInput!]) |
Mutations
createContract mutation
Creates a contract.
createContract(input: CreateContractInput!): CreateContractPayload!
Returns: CreateContractPayload!
Arguments for createContract
| Name | Description |
|---|---|
input (CreateContractInput!) |
createManualLicensePlan mutation
Creates a manually managed license plan for a vendor or product. Use this to track a plan that is not discovered automatically through an integration.
createManualLicensePlan(input: CreateManualLicensePlanInput!): CreateManualLicensePlanPayload!
Returns: CreateManualLicensePlanPayload!
Arguments for createManualLicensePlan
| Name | Description |
|---|---|
input (CreateManualLicensePlanInput!) |
linkContracts mutation
Links a contract to other contracts.
linkContracts(input: LinkContractsInput!): LinkContractsPayload!
Returns: LinkContractsPayload!
Arguments for linkContracts
| Name | Description |
|---|---|
input (LinkContractsInput!) |
removeContracts mutation
Removes the contracts that match the given filter.
removeContracts(where: ContractFilterInput): RemoveContractsPayload!
Returns: RemoveContractsPayload!
Arguments for removeContracts
| Name | Description |
|---|---|
where (ContractFilterInput) |
unlinkContracts mutation
Removes links between contracts.
unlinkContracts(input: UnlinkContractsInput!): UnlinkContractsPayload!
Returns: UnlinkContractsPayload!
Arguments for unlinkContracts
| Name | Description |
|---|---|
input (UnlinkContractsInput!) |
updateContractDatesAndTerms mutation
Changes a contract's dates and renewal terms.
updateContractDatesAndTerms(input: UpdateContractDatesAndTermsInput!): UpdateContractDatesAndTermsPayload!
Returns: UpdateContractDatesAndTermsPayload!
Arguments for updateContractDatesAndTerms
| Name | Description |
|---|---|
input (UpdateContractDatesAndTermsInput!) |
updateContractName mutation
Changes a contract's name.
updateContractName(input: UpdateContractNameInput!): UpdateContractNamePayload!
Returns: UpdateContractNamePayload!
Arguments for updateContractName
| Name | Description |
|---|---|
input (UpdateContractNameInput!) |
updateContractNumber mutation
Changes a contract's number.
updateContractNumber(input: UpdateContractNumberInput!): UpdateContractNumberPayload!
Returns: UpdateContractNumberPayload!
Arguments for updateContractNumber
| Name | Description |
|---|---|
input (UpdateContractNumberInput!) |
updateContractPaymentTerms mutation
Changes a contract's value and payment terms.
updateContractPaymentTerms(input: UpdateContractPaymentTermsInput!): UpdateContractPaymentTermsPayload!
Returns: UpdateContractPaymentTermsPayload!
Arguments for updateContractPaymentTerms
| Name | Description |
|---|---|
input (UpdateContractPaymentTermsInput!) |
updateContractReferenceTarget mutation
Changes the vendor or product a contract applies to.
updateContractReferenceTarget(input: UpdateContractReferenceTargetInput!): UpdateContractReferenceTargetPayload!
Returns: UpdateContractReferenceTargetPayload!
Arguments for updateContractReferenceTarget
| Name | Description |
|---|---|
input (UpdateContractReferenceTargetInput!) |
updateContractsOwner mutation
Changes the owner of the contracts that match the given filter.
updateContractsOwner(input: UpdateContractsOwnerInput!, where: ContractFilterInput): UpdateContractsOwnerPayload!
Returns: UpdateContractsOwnerPayload!
Arguments for updateContractsOwner
| Name | Description |
|---|---|
input (UpdateContractsOwnerInput!) | |
where (ContractFilterInput) |
updateContractSupplier mutation
Changes a contract's supplier.
updateContractSupplier(input: UpdateContractSupplierInput!): UpdateContractSupplierPayload!
Returns: UpdateContractSupplierPayload!
Arguments for updateContractSupplier
| Name | Description |
|---|---|
input (UpdateContractSupplierInput!) |
Objects
AggregatedLicensePlans object
Fields returned by the AggregatedLicensePlans object type.
| Name | Description |
|---|---|
criteria (AggregatedLicensePlansCriteria) | |
upcomingRenewalContract (ContractDetails) | |
usageStats (AggregatedUsageLicenseStats) | |
pricingStats (LicensePlanPricingStats) | |
plans ([LicensePlan!]!) |
AggregatedLicensePlansAttributeCriteria object
Fields returned by the AggregatedLicensePlansAttributeCriteria object type.
| Name | Description |
|---|---|
value (String!) |
AggregatedLicensePlansConnection object
A connection to a list of items.
| Name | Description |
|---|---|
pageInfo (PageInfo!) | Information to aid in pagination. |
edges ([AggregatedLicensePlansEdge!]) | A list of edges. |
nodes ([AggregatedLicensePlans!]) | A flattened list of the nodes. |
totalCount (Int!) | Identifies the total count of items in the connection. |
AggregatedLicensePlansEdge object
An edge in a connection.
| Name | Description |
|---|---|
cursor (String!) | A cursor for use in pagination. |
node (AggregatedLicensePlans!) | The item at the end of the edge. |
AggregatedLicensePlansIntegrationCriteria object
Fields returned by the AggregatedLicensePlansIntegrationCriteria object type.
| Name | Description |
|---|---|
id (ID!) | |
integration (Integration) |
AggregatedLicensePlansProductCriteria object
Fields returned by the AggregatedLicensePlansProductCriteria object type.
| Name | Description |
|---|---|
id (ID!) | |
type (ProductType!) | |
product (Product) |
AggregatedLicensePlansVendorCriteria object
Fields returned by the AggregatedLicensePlansVendorCriteria object type.
| Name | Description |
|---|---|
id (ID!) | |
vendor (Vendor) |
AggregatedUsageLicenseStats object
Fields returned by the AggregatedUsageLicenseStats object type.
| Name | Description |
|---|---|
inUse (InUseLicensePlanStats!) | |
unused (UnusedLicensePlanStats!) | |
noData (NoDataLicensePlanStats!) | |
downgradable (DowngradableLicensePlanStats!) | |
assigned (Int!) | |
unassigned (Int) | |
wasted (Int!) | |
total (Int) | |
effective (Int!) |
BulkIntegrationLicenseDetails object
Fields returned by the BulkIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
currency (OriginValueOfString!) | |
costPerLicense (OriginValueOfDouble!) | |
licensesCount (OriginValueOfInt32!) | |
calculationMethod (CountCalculationMethod!) | |
licensePeriod (OriginValueOfInt32!) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
BulkPricingModel object
Fields returned by the BulkPricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
Contract object
A contract with a supplier, optionally scoped to a vendor or product.
| Name | Description |
|---|---|
id (ID!) | The unique identifier of the contract. |
reference (ContractReferenceTarget) | The vendor or product the contract applies to. |
ownerId (ID) | The identifier of the employee who owns the contract. |
name (String!) | The name shown for the contract. |
contractNumber (String) | The reference number of the contract. |
supplier (String) | The supplier the contract is with. |
startDate (Date) | The date the contract starts. |
endDate (Date) | The date the contract ends. |
status (ContractStatus) | The current status of the contract. |
termInMonths (Int) | The duration of the contract in months. |
autoRenewEnabled (Boolean!) | Whether the contract renews automatically. |
upcomingRenewalDate (Date) | The next date the contract is due to renew. |
noticePeriodInDays (Int) | How many days of notice are required to cancel before the contract renews. |
cancelByDate (Date) | The last date to cancel before the contract renews. |
originalTotalContractValue (ContractPrice) | The total contract value in the currency it was entered in. |
totalContractValue (ContractPrice) | The total contract value converted to the workspace currency. |
annualContractValue (ContractPrice) | The contract value expressed as a yearly amount, in the workspace currency. |
billingFrequency (BillingFrequency) | How often the contract is billed. |
paymentTerms (String) | The payment terms agreed with the supplier. |
links ([ContractLink!]!) | Links from this contract to other contracts. |
linkedBy ([ContractLink!]!) | Links from other contracts to this contract. |
licensePlans (LicensePlansConnection) | The license plans assigned to this contract. |
owner (Employee) |
ContractDetails object
Fields returned by the ContractDetails object type.
| Name | Description |
|---|---|
startDate (OriginValueOfDateOnly) | |
billingFrequency (OriginValueOfInt32) | Number of months |
renewal (ContractRenewal) | |
type (ContractType!) |
ContractLink object
A link from one contract to another.
| Name | Description |
|---|---|
type (ContractLinkType!) | How the two contracts are linked. |
contract (Contract) | The linked contract. |
ContractNotFoundError object
Indicates that the requested contract does not exist.
| Name | Description |
|---|---|
message (String!) | An explanation of the error. |
ContractPrice object
A monetary amount in a given currency.
| Name | Description |
|---|---|
currency (String!) | The three-letter ISO currency code, e.g. USD. |
amount (Float!) | The amount in the given currency. |
ContractRenewal object
Fields returned by the ContractRenewal object type.
| Name | Description |
|---|---|
upcomingDate (OriginValueOfDateOnly) | Upcoming renewal date |
terminationPeriod (OriginValueOfInt32) | Number of days before the contract renewal date, after which contract renewal cannot be canceled |
ContractsConnection object
A connection to a list of items.
| Name | Description |
|---|---|
pageInfo (PageInfo!) | Information to aid in pagination. |
edges ([ContractsEdge!]) | A list of edges. |
nodes ([Contract!]) | A flattened list of the nodes. |
totalCount (Int!) | Identifies the total count of items in the connection. |
ContractsEdge object
An edge in a connection.
| Name | Description |
|---|---|
cursor (String!) | A cursor for use in pagination. |
node (Contract!) | The item at the end of the edge. |
CostCenterBucketKey object
Fields returned by the CostCenterBucketKey object type.
| Name | Description |
|---|---|
costCenter (String) |
CountCalculationMethod object
Count calculation method
| Name | Description |
|---|---|
type (CountCalculationType!) | Calculation type |
amount (Int) | Manual amount |
CountryBucketKey object
Fields returned by the CountryBucketKey object type.
| Name | Description |
|---|---|
country (String) |
CreateContractPayload object
The result of creating a contract.
| Name | Description |
|---|---|
contract (Contract) | The newly created contract. Null when creation failed. |
errors ([CreateContractError!]) | The reasons the contract was not created. Null when creation succeeded. |
CreateManualLicensePlanPayload object
The result of creating a manual license plan. Exactly one outcome applies: on success licensePlan is set and errors is empty; on failure licensePlan is null and errors explains why.
| Name | Description |
|---|---|
licensePlan (LicensePlan) | The newly created plan. Null when creation failed. |
errors ([CreateManualLicensePlanError!]) | The reasons the plan was not created. Null when creation succeeded. |
DivisionBucketKey object
Fields returned by the DivisionBucketKey object type.
| Name | Description |
|---|---|
division (String) |
DowngradableLicensePlanStats object
Fields returned by the DowngradableLicensePlanStats object type.
| Name | Description |
|---|---|
total (Int!) |
DowngradableLicenseState object
Fields returned by the DowngradableLicenseState object type.
| Name | Description |
|---|---|
activity (LicenseActivity!) | |
reason (LicenseDowngradeReason!) | |
target (LicenseDowngradeTarget!) |
EmployeeStatusBucketKey object
Fields returned by the EmployeeStatusBucketKey object type.
| Name | Description |
|---|---|
employeeStatus (EmployeeStatus) |
EntitledLicenses object
How many licenses a plan includes.
| Name | Description |
|---|---|
api (Int) | The license count reported by the integration, when available. |
manual (Int) | The license count entered manually, when provided. |
effective (Int) | The count to rely on: the manual value when set, otherwise the value from the integration. |
ExternalKey object
Fields returned by the ExternalKey object type.
| Name | Description |
|---|---|
integrationKey (String!) | |
tenant (String) |
ExternalUser object
Fields returned by the ExternalUser object type.
| Name | Description |
|---|---|
sourceId (String!) | |
name (String) | |
email (String) | |
roles ([String!]!) |
FlatFeeIntegrationLicenseDetails object
Fields returned by the FlatFeeIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
currency (OriginValueOfString!) | |
flatFee (OriginValueOfDouble!) | |
useLicensesCount (Boolean!) | |
licensesCount (OriginValueOfInt32) | |
licensePeriod (OriginValueOfInt32!) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
FlatFeePricingModel object
Fields returned by the FlatFeePricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
FreeIntegrationLicenseDetails object
Fields returned by the FreeIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
useLicensesCount (Boolean!) | |
licensesCount (OriginValueOfInt32) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
FreePricingModel object
Fields returned by the FreePricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
IntegratedLicensePlan object
Fields returned by the IntegratedLicensePlan object type.
| Name | Description |
|---|---|
id (ID!) | |
origin (LicensePlanOrigin!) | |
externalId (String) | |
directIntegrationInstallationId (ID) | |
externalKey (ExternalKey) | |
name (String!) | |
pricing (PricingModel!) | |
pricingComponents ([LicensePlanPricingComponent!]) | The plan's price list — the charges that make up its cost. |
contractDetails (ContractDetails) | |
entitledLicenses (EntitledLicenses) | |
usageStats (LicensePlanUsageStats) | |
pricingStats (LicensePlanPricingStats) | |
originalPricingStats (LicensePlanPricingStats) | |
attributes ([LicensePlanAttribute!]) | |
reference (LicenseReferenceTarget!) | |
directIntegrationInstallation (DirectIntegrationInstallation) |
IntegratedLicensePlanExistsError object
The plan was not created because an integration already manages a plan for the requested vendor or product.
| Name | Description |
|---|---|
message (String!) | An explanation of the error. |
InUseLicensePlanStats object
Fields returned by the InUseLicensePlanStats object type.
| Name | Description |
|---|---|
hasRecentUsage (Int!) | |
ssoLogin (Int!) | |
excludedFromAnalysis (Int!) | |
total (Int!) |
InUseLicenseState object
Fields returned by the InUseLicenseState object type.
| Name | Description |
|---|---|
activity (LicenseActivity!) | |
reason (InUseLicenseStateReason!) |
InvalidContractDateError object
Indicates that the contract's end date is before its start date.
| Name | Description |
|---|---|
message (String!) | An explanation of the error. |
License object
Fields returned by the License object type.
| Name | Description |
|---|---|
id (ID!) | |
state (LicenseState!) | |
holder (LicenseHolder!) | |
usage (LicenseUsage!) | |
annualPrice (LicensePrice) | |
originalAnnualPrice (LicensePrice) | |
potentialSaving (LicensePrice) | |
originalPotentialSaving (LicensePrice) | |
reference (LicenseReferenceTarget!) | |
plan (LicensePlan!) | |
customerIntegration (Integration) | |
integrationActions ([IntegrationAction!]!) | |
userUsage (UserUsage) |
LicenseAnalyticsBucket object
Fields returned by the LicenseAnalyticsBucket object type.
| Name | Description |
|---|---|
key (LicenseAnalyticsBucketKey!) | |
metrics (LicenseAnalyticsMetrics!) |
LicenseAnalyticsMetrics object
Fields returned by the LicenseAnalyticsMetrics object type.
| Name | Description |
|---|---|
licenseCount (Int!) | |
inUseCount (Int!) | |
unusedCount (Int!) | |
noDataCount (Int!) | |
downgradableCount (Int!) | |
utilizationPercentage (Float) | |
totalAnnualCost (LicensePrice) | |
potentialSaving (LicensePrice) | |
potentialSavingPercentage (Float) |
LicenseAnalyticsResult object
Fields returned by the LicenseAnalyticsResult object type.
| Name | Description |
|---|---|
buckets ([LicenseAnalyticsBucket!]!) | |
totals (LicenseAnalyticsMetrics!) |
LicenseDetailedSource object
Fields returned by the LicenseDetailedSource object type.
| Name | Description |
|---|---|
dataSource (DiscoverySourceName!) | |
integrationId (ID) | |
firstUsed (Date) | |
lastUsed (Date) | |
isPrimary (Boolean!) | |
customerIntegration (Integration) |
LicenseDowngradeExclusiveUsageReason object
Fields returned by the LicenseDowngradeExclusiveUsageReason object type.
| Name | Description |
|---|---|
productIds ([ID!]!) | |
products (ProductsConnection) |
LicenseDowngradeNoUsageReason object
Fields returned by the LicenseDowngradeNoUsageReason object type.
| Name | Description |
|---|---|
productIds ([ID!]!) | |
products (ProductsConnection) |
LicenseDowngradeTarget object
Fields returned by the LicenseDowngradeTarget object type.
| Name | Description |
|---|---|
planTemplateId (ID!) | |
planId (ID) | |
annualUnitPrice (LicensePrice) | |
planTemplate (PlanTemplate!) | |
plan (LicensePlan) |
LicenseHolder object
Fields returned by the LicenseHolder object type.
| Name | Description |
|---|---|
name (String) | |
email (String) | |
external (ExternalUser!) | |
employeeId (ID) | |
employee (Employee) |
LicensePlanAttribute object
Fields returned by the LicensePlanAttribute object type.
| Name | Description |
|---|---|
key (String!) | |
value (String!) |
LicensePlanFixedFeePricingComponent object
A fixed recurring charge billed at a set frequency, regardless of how many licenses are used.
| Name | Description |
|---|---|
billingFrequency (BillingFrequency!) | How often the fixed fee is charged, for example monthly or yearly. |
price (LicensePrice!) | The amount charged each billing period. |
LicensePlanPotentialSaving object
Fields returned by the LicensePlanPotentialSaving object type.
| Name | Description |
|---|---|
amount (Float!) | |
percentage (Float!) | |
rate (LicensePlanPotentialSavingRate!) |
LicensePlanPricingStats object
Fields returned by the LicensePlanPricingStats object type.
| Name | Description |
|---|---|
currency (String!) | |
annualUnitPrice (Float) | |
annualCost (Float!) | |
potentialSaving (LicensePlanPotentialSaving!) |
LicensePlansConnection object
A connection to a list of items.
| Name | Description |
|---|---|
pageInfo (PageInfo!) | Information to aid in pagination. |
edges ([LicensePlansEdge!]) | A list of edges. |
nodes ([LicensePlan!]) | A flattened list of the nodes. |
totalCount (Int!) | Identifies the total count of items in the connection. |
LicensePlansEdge object
An edge in a connection.
| Name | Description |
|---|---|
cursor (String!) | A cursor for use in pagination. |
node (LicensePlan!) | The item at the end of the edge. |
LicensePlanUsageStats object
Fields returned by the LicensePlanUsageStats object type.
| Name | Description |
|---|---|
inUse (InUseLicensePlanStats!) | |
unused (UnusedLicensePlanStats!) | |
noData (NoDataLicensePlanStats!) | |
downgradable (DowngradableLicensePlanStats!) | |
assigned (Int!) | |
unassigned (Int) | |
wasted (Int!) | |
total (Int) | |
effective (Int!) | |
usageAvailability (UsageAvailability!) |
LicensePrice object
Fields returned by the LicensePrice object type.
| Name | Description |
|---|---|
currency (String!) | |
amount (Float!) |
LicensesConnection object
A connection to a list of items.
| Name | Description |
|---|---|
pageInfo (PageInfo!) | Information to aid in pagination. |
edges ([LicensesEdge!]) | A list of edges. |
nodes ([License!]) | A flattened list of the nodes. |
totalCount (Int!) | Identifies the total count of items in the connection. |
LicensesEdge object
An edge in a connection.
| Name | Description |
|---|---|
cursor (String!) | A cursor for use in pagination. |
node (License!) | The item at the end of the edge. |
LicenseUsage object
Fields returned by the LicenseUsage object type.
| Name | Description |
|---|---|
detailedSources ([LicenseDetailedSource!]!) | |
lastUsed (Date) |
LinkContractsPayload object
The result of linking a contract to other contracts.
| Name | Description |
|---|---|
contracts ([Contract!]) | The contracts affected by the operation: the contract the links were added to, followed by the contracts it was linked to. Null when the operation failed. |
errors ([LinkContractsError!]) | The reasons the contracts were not linked. Null when the operation succeeded. |
ManualLicensePlan object
Fields returned by the ManualLicensePlan object type.
| Name | Description |
|---|---|
id (ID!) | |
origin (LicensePlanOrigin!) | |
name (String!) | |
pricing (PricingModel!) | |
pricingComponents ([LicensePlanPricingComponent!]) | The plan's price list — the charges that make up its cost. |
contractDetails (ContractDetails) | |
entitledLicenses (EntitledLicenses) | |
pricingStats (LicensePlanPricingStats) | |
originalPricingStats (LicensePlanPricingStats) | |
reference (LicenseReferenceTarget!) |
NoDataLicensePlanStats object
Fields returned by the NoDataLicensePlanStats object type.
| Name | Description |
|---|---|
newEmployee (Int!) | |
noUsageDetected (Int!) | |
total (Int!) |
NoDataLicenseState object
Fields returned by the NoDataLicenseState object type.
| Name | Description |
|---|---|
activity (LicenseActivity!) | |
reason (NoDataLicenseStateReason!) |
OriginValueOfDateOnly object
Fields returned by the OriginValueOfDateOnly object type.
| Name | Description |
|---|---|
origin (DataOrigin!) | |
value (Date!) |
OriginValueOfDouble object
Fields returned by the OriginValueOfDouble object type.
| Name | Description |
|---|---|
origin (DataOrigin!) | |
value (Float!) |
OriginValueOfInt32 object
Fields returned by the OriginValueOfInt32 object type.
| Name | Description |
|---|---|
origin (DataOrigin!) | |
value (Int!) |
OriginValueOfLicenseDetailsType object
Fields returned by the OriginValueOfLicenseDetailsType object type.
| Name | Description |
|---|---|
origin (DataOrigin!) | |
value (PricingModelType!) |
OriginValueOfString object
Fields returned by the OriginValueOfString object type.
| Name | Description |
|---|---|
origin (DataOrigin!) | |
value (String) |
PerLicenseIntegrationLicenseDetails object
Fields returned by the PerLicenseIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
currency (OriginValueOfString!) | |
costPerLicense (OriginValueOfDouble!) | |
calculationMethod (CountCalculationMethod!) | |
apiProvidedLicensesCount (Int) | |
licensePeriod (OriginValueOfInt32!) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
PerLicensePricingModel object
Fields returned by the PerLicensePricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
Plan object
Fields returned by the Plan object type.
| Name | Description |
|---|---|
id (ID!) | |
customerIntegrationId (ID!) | |
vendorId (ID) | |
applicationId (ID) | |
name (String!) | |
type (PlanType!) | |
contractDetails (ContractDetails) | |
sourceId (String!) | |
licenseDetails (IntegrationLicenseDetails) | |
rawLicenseDetails (RawIntegrationLicenseDetails!) | |
application (Application) | |
vendor (Vendor) | |
customerIntegration (Integration) |
PlanBucketKey object
Fields returned by the PlanBucketKey object type.
| Name | Description |
|---|---|
planId (ID!) | |
plan (LicensePlan!) |
PlanTemplate object
Fields returned by the PlanTemplate object type.
| Name | Description |
|---|---|
id (ID!) | |
externalPlanName (String!) | |
displayPlanName (String!) | |
pricingModel (PricingModel) | |
licensePlans (LicensePlansConnection) |
PricingModelBucketKey object
Fields returned by the PricingModelBucketKey object type.
| Name | Description |
|---|---|
pricingModel (PricingModelType) |
ProductBucketKey object
Fields returned by the ProductBucketKey object type.
| Name | Description |
|---|---|
productId (ID) | |
product (Product) |
ProductNotFoundError object
Indicates that the referenced product does not exist.
| Name | Description |
|---|---|
message (String!) | An explanation of the error. |
ProductReference object
A reference to a product.
| Name | Description |
|---|---|
productId (ID!) | The identifier of the product. |
productType (ProductType!) | The type of the product. |
product (Product) |
RawIntegrationLicenseDetails object
Fields returned by the RawIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) | |
useLicensesCount (Boolean) | |
licensesCount (OriginValueOfInt32) | |
currency (OriginValueOfString) | |
overallCost (OriginValueOfDouble) | |
licensePeriod (OriginValueOfInt32) | |
costPerLicense (OriginValueOfDouble) | |
calculationMethod (CountCalculationMethod) | |
apiProvidedLicensesCount (Int) | |
steps ([RawIntegrationLicenseDetailsStep!]) |
RawIntegrationLicenseDetailsStep object
Fields returned by the RawIntegrationLicenseDetailsStep object type.
| Name | Description |
|---|---|
minCount (OriginValueOfInt32!) | |
cost (OriginValueOfDouble!) |
RemoveContractsPayload object
The result of removing contracts.
| Name | Description |
|---|---|
removedCount (Int!) | The number of contracts that were removed. |
StairStepIntegrationLicenseDetails object
Fields returned by the StairStepIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
currency (OriginValueOfString!) | |
calculationMethod (CountCalculationMethod!) | |
apiProvidedLicensesCount (Int) | |
licensePeriod (OriginValueOfInt32!) | |
steps ([StairStepIntegrationLicenseDetailsStep!]!) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
StairStepIntegrationLicenseDetailsStep object
Fields returned by the StairStepIntegrationLicenseDetailsStep object type.
| Name | Description |
|---|---|
minCount (OriginValueOfInt32!) | |
cost (OriginValueOfDouble!) |
StairStepPricingModel object
Fields returned by the StairStepPricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
StateBucketKey object
Fields returned by the StateBucketKey object type.
| Name | Description |
|---|---|
state (LicenseActivity!) |
StateReasonBucketKey object
Fields returned by the StateReasonBucketKey object type.
| Name | Description |
|---|---|
stateReason (String) |
UnknownIntegrationLicenseDetails object
Fields returned by the UnknownIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
rawCurrency (OriginValueOfString) | |
rawCostPerLicense (OriginValueOfDouble) | |
rawOverallCost (OriginValueOfDouble) | |
rawUseLicensesCount (Boolean) | |
rawLicensesCount (OriginValueOfInt32) | |
rawCalculationMethod (CountCalculationMethod) | |
rawApiProvidedLicensesCount (Int) | |
rawLicensePeriod (OriginValueOfInt32) | |
rawSteps ([UnknownLicenseDetailsStep!]) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
UnknownLicenseDetailsStep object
Fields returned by the UnknownLicenseDetailsStep object type.
| Name | Description |
|---|---|
minCount (OriginValueOfInt32) | |
cost (OriginValueOfDouble) |
UnknownPricingModel object
Fields returned by the UnknownPricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
UnlinkContractsPayload object
The result of removing links between contracts.
| Name | Description |
|---|---|
contracts ([Contract!]) | The contracts affected by the operation: the contract the links were removed from, followed by the contracts that were unlinked. Null when the operation failed. |
errors ([UnlinkContractsError!]) | The reasons the links were not removed. Null when the operation succeeded. |
UnusedLicensePlanStats object
Fields returned by the UnusedLicensePlanStats object type.
| Name | Description |
|---|---|
noRecentUsage (Int!) | |
noSsoLogin (Int!) | |
leftOrganization (Int!) | |
total (Int!) |
UnusedLicenseState object
Fields returned by the UnusedLicenseState object type.
| Name | Description |
|---|---|
activity (LicenseActivity!) | |
reason (UnusedLicenseStateReason!) |
UpdateContractDatesAndTermsPayload object
The result of changing a contract's dates and renewal terms.
| Name | Description |
|---|---|
contract (Contract) | The updated contract. Null when the update failed. |
errors ([UpdateContractDatesAndTermsError!]) | The reasons the contract was not updated. Null when the update succeeded. |
UpdateContractNamePayload object
The result of renaming a contract.
| Name | Description |
|---|---|
contract (Contract) | The updated contract. Null when the update failed. |
errors ([UpdateContractNameError!]) | The reasons the contract was not updated. Null when the update succeeded. |
UpdateContractNumberPayload object
The result of changing a contract's number.
| Name | Description |
|---|---|
contract (Contract) | The updated contract. Null when the update failed. |
errors ([UpdateContractNumberError!]) | The reasons the contract was not updated. Null when the update succeeded. |
UpdateContractPaymentTermsPayload object
The result of changing a contract's value and payment terms.
| Name | Description |
|---|---|
contract (Contract) | The updated contract. Null when the update failed. |
errors ([UpdateContractPaymentTermsError!]) | The reasons the contract was not updated. Null when the update succeeded. |
UpdateContractReferenceTargetPayload object
The result of changing the vendor or product a contract applies to.
| Name | Description |
|---|---|
contract (Contract) | The updated contract. Null when the update failed. |
errors ([UpdateContractReferenceTargetError!]) | The reasons the contract was not updated. Null when the update succeeded. |
UpdateContractsOwnerPayload object
The result of changing the owner of contracts.
| Name | Description |
|---|---|
updatedCount (Int!) | The number of contracts that were updated. |
UpdateContractSupplierPayload object
The result of changing a contract's supplier.
| Name | Description |
|---|---|
contract (Contract) | The updated contract. Null when the update failed. |
errors ([UpdateContractSupplierError!]) | The reasons the contract was not updated. Null when the update succeeded. |
UsageAvailability object
Fields returned by the UsageAvailability object type.
| Name | Description |
|---|---|
status (UsageAvailabilityStatus!) |
VendorBucketKey object
Fields returned by the VendorBucketKey object type.
| Name | Description |
|---|---|
vendorName (String!) |
VendorNotFoundError object
Indicates that the referenced vendor does not exist.
| Name | Description |
|---|---|
message (String!) | An explanation of the error. |
VendorReference object
A reference to a vendor.
| Name | Description |
|---|---|
vendorId (ID!) | The identifier of the vendor. |
vendor (Vendor) |
VolumeIntegrationLicenseDetails object
Fields returned by the VolumeIntegrationLicenseDetails object type.
| Name | Description |
|---|---|
currency (OriginValueOfString!) | |
calculationMethod (CountCalculationMethod!) | |
apiProvidedLicensesCount (Int) | |
licensePeriod (OriginValueOfInt32!) | |
steps ([VolumeIntegrationLicenseDetailsStep!]!) | |
type (OriginValueOfLicenseDetailsType!) | |
label (OriginValueOfString!) | |
description (String) |
VolumeIntegrationLicenseDetailsStep object
Fields returned by the VolumeIntegrationLicenseDetailsStep object type.
| Name | Description |
|---|---|
minCount (OriginValueOfInt32!) | |
cost (OriginValueOfDouble!) |
VolumePricingModel object
Fields returned by the VolumePricingModel object type.
| Name | Description |
|---|---|
type (PricingModelType!) |
Input Types
AggregatedLicensePlansGroupByInput input
Input fields accepted by AggregatedLicensePlansGroupByInput.
| Name | Description |
|---|---|
product (Boolean) | |
reference (Boolean) | |
integration (Boolean) | |
attribute (LicensePlanGroupingAttribute) |
ContractDetailsFilterInput input
Input fields accepted by ContractDetailsFilterInput.
| Name | Description |
|---|---|
and ([ContractDetailsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([ContractDetailsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
startDate (OriginValueOfDateOnlyFilterInput) | |
renewal (ContractRenewalFilterInput) | |
type (ContractTypeOperationFilterInput) |
ContractDetailsSortInput input
Input fields accepted by ContractDetailsSortInput.
| Name | Description |
|---|---|
startDate (OriginValueOfDateOnlySortInput) | |
renewal (ContractRenewalSortInput) |
ContractFilterInput input
Input fields accepted by ContractFilterInput.
| Name | Description |
|---|---|
and ([ContractFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([ContractFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
id (ComparableIdTypeOperationFilterInput) | |
reference (LicenseReferenceTargetFilterInput) | |
name (StringOperationFilterInput) | |
contractNumber (StringOperationFilterInput) | |
supplier (StringOperationFilterInput) | |
startDate (DateOperationFilterInput) | |
endDate (DateOperationFilterInput) | |
status (NullableOfContractStatusOperationFilterInput) | |
termInMonths (IntOperationFilterInput) | |
autoRenewEnabled (BooleanOperationFilterInput) | |
upcomingRenewalDate (DateOperationFilterInput) | |
cancelByDate (DateOperationFilterInput) | |
billingFrequency (NullableOfBillingFrequencyOperationFilterInput) |
ContractLinkInput input
A link from one contract to another.
| Name | Description |
|---|---|
type (ContractLinkType!) | How the two contracts are linked. |
contractId (ID!) | The identifier of the contract to link to. |
ContractPriceInput input
A monetary amount in a given currency.
| Name | Description |
|---|---|
currency (String!) | The three-letter ISO currency code, e.g. USD. |
amount (Float!) | The amount in the given currency. |
ContractRenewalFilterInput input
Input fields accepted by ContractRenewalFilterInput.
| Name | Description |
|---|---|
and ([ContractRenewalFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([ContractRenewalFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
upcomingDate (OriginValueOfDateOnlyFilterInput) | |
isNullish (Boolean) | Matches when the field is null or missing (not present in the database). |
ContractRenewalSortInput input
Input fields accepted by ContractRenewalSortInput.
| Name | Description |
|---|---|
upcomingDate (OriginValueOfDateOnlySortInput) | |
terminationPeriod (OriginValueOfInt32SortInput) | |
originalUpcomingDate (SortEnumType) |
ContractSortInput input
Input fields accepted by ContractSortInput.
| Name | Description |
|---|---|
id (SortEnumType) | |
name (SortEnumType) | |
termInMonths (SortEnumType) | |
startDate (SortEnumType) | |
endDate (SortEnumType) | |
upcomingRenewalDate (SortEnumType) |
CreateContractInput input
The details needed to create a contract.
| Name | Description |
|---|---|
reference (ReferenceTargetInput) | The vendor or product the contract applies to. Leave empty for a contract without a scope. |
ownerId (ID) | The identifier of the employee who owns the contract. |
name (String!) | The name shown for the contract. |
contractNumber (String) | The reference number of the contract. |
supplier (String) | The supplier the contract is with. |
startDate (Date) | The date the contract starts. |
endDate (Date) | The date the contract ends. |
autoRenewEnabled (Boolean!) | Whether the contract renews automatically. |
upcomingRenewalDate (Date) | The next date the contract is due to renew. |
noticePeriodInDays (Int) | How many days of notice are required to cancel before the contract renews. |
totalContractValue (ContractPriceInput) | The total value of the contract over its whole term. |
billingFrequency (BillingFrequency) | How often the contract is billed. |
paymentTerms (String) | The payment terms agreed with the supplier, e.g. "Net 30". |
CreateManualLicensePlanInput input
The details needed to create a manual license plan.
| Name | Description |
|---|---|
reference (ReferenceTargetInput!) | The vendor or product this plan applies to. |
name (String!) | The name shown for the plan. |
entitledLicenses (Int) | How many licenses the plan includes. Leave empty if the number is unknown. |
pricingComponents ([LicensePlanPricingComponentInput!]!) | The plan's full price list. |
DataOriginOperationFilterInput input
Input fields accepted by DataOriginOperationFilterInput.
| Name | Description |
|---|---|
eq (DataOrigin) | Matches when the field value is exactly equal to the given value. |
neq (DataOrigin) | Matches when the field value is not equal to the given value. |
in ([DataOrigin!]) | Matches when the field value is one of the values in the given list. |
nin ([DataOrigin!]) | Matches when the field value is none of the values in the given list. |
DowngradableLicensePlanStatsFilterInput input
Input fields accepted by DowngradableLicensePlanStatsFilterInput.
| Name | Description |
|---|---|
and ([DowngradableLicensePlanStatsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([DowngradableLicensePlanStatsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
total (IntOperationFilterInput) |
DowngradableLicensePlanStatsSortInput input
Input fields accepted by DowngradableLicensePlanStatsSortInput.
| Name | Description |
|---|---|
total (SortEnumType) |
EqualOnlyOperationFilterInputTypeOfIdTypeFilterInput input
Input fields accepted by EqualOnlyOperationFilterInputTypeOfIdTypeFilterInput.
| Name | Description |
|---|---|
eq (ID) | Matches when the field value is exactly equal to the given value. |
ExternalKeyFilterInput input
Input fields accepted by ExternalKeyFilterInput.
| Name | Description |
|---|---|
and ([ExternalKeyFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([ExternalKeyFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
integrationKey (StringOperationFilterInput) | |
tenant (StringOperationFilterInput) |
ExternalUserFilterInput input
Input fields accepted by ExternalUserFilterInput.
| Name | Description |
|---|---|
and ([ExternalUserFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([ExternalUserFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
sourceId (StringOperationFilterInput) | |
name (StringOperationFilterInput) | |
email (StringOperationFilterInput) | |
roles (ListStringOperationFilterInput) |
InUseLicensePlanStatsFilterInput input
Input fields accepted by InUseLicensePlanStatsFilterInput.
| Name | Description |
|---|---|
and ([InUseLicensePlanStatsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([InUseLicensePlanStatsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
hasRecentUsage (IntOperationFilterInput) | |
ssoLogin (IntOperationFilterInput) | |
excludedFromAnalysis (IntOperationFilterInput) | |
total (IntOperationFilterInput) |
InUseLicensePlanStatsSortInput input
Input fields accepted by InUseLicensePlanStatsSortInput.
| Name | Description |
|---|---|
hasRecentUsage (SortEnumType) | |
ssoLogin (SortEnumType) | |
excludedFromAnalysis (SortEnumType) | |
total (SortEnumType) |
LicenseActivityOperationFilterInput input
Input fields accepted by LicenseActivityOperationFilterInput.
| Name | Description |
|---|---|
eq (LicenseActivity) | Matches when the field value is exactly equal to the given value. |
neq (LicenseActivity) | Matches when the field value is not equal to the given value. |
in ([LicenseActivity!]) | Matches when the field value is one of the values in the given list. |
nin ([LicenseActivity!]) | Matches when the field value is none of the values in the given list. |
LicenseAnalyticsBucketSortInput input
Input fields accepted by LicenseAnalyticsBucketSortInput.
| Name | Description |
|---|---|
metrics (LicenseAnalyticsMetricsSortInput) |
LicenseAnalyticsInput input
Input fields accepted by LicenseAnalyticsInput.
| Name | Description |
|---|---|
groupBy (LicenseAnalyticsDimension!) | |
topN (Int!) |
LicenseAnalyticsMetricsSortInput input
Input fields accepted by LicenseAnalyticsMetricsSortInput.
| Name | Description |
|---|---|
licenseCount (SortEnumType) | |
inUseCount (SortEnumType) | |
unusedCount (SortEnumType) | |
noDataCount (SortEnumType) | |
downgradableCount (SortEnumType) | |
utilizationPercentage (SortEnumType) | |
potentialSavingPercentage (SortEnumType) | |
totalAnnualCost (LicensePriceSortInput) | |
potentialSaving (LicensePriceSortInput) |
LicenseDetailedSourceFilterInput input
Input fields accepted by LicenseDetailedSourceFilterInput.
| Name | Description |
|---|---|
and ([LicenseDetailedSourceFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseDetailedSourceFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
dataSource (DiscoverySourceNameOperationFilterInput) | |
firstUsed (DateOperationFilterInput) | |
lastUsed (DateOperationFilterInput) | |
isPrimary (BooleanOperationFilterInput) |
LicenseFilterInput input
Input fields accepted by LicenseFilterInput.
| Name | Description |
|---|---|
and ([LicenseFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
externalKey (ExternalKeyFilterInput) | |
reference (LicenseReferenceTargetFilterInput) | |
state (LicenseStateFilterInput) | |
holder (LicenseHolderFilterInput) | |
plan (LicensePlanReducedModelFilterInput) | |
usage (LicenseUsageFilterInput) | |
annualPrice (LicensePriceFilterInput) | |
originalAnnualPrice (LicensePriceFilterInput) | |
potentialSaving (LicensePriceFilterInput) | |
originalPotentialSaving (LicensePriceFilterInput) |
LicenseHolderEmployeeFilterInput input
Input fields accepted by LicenseHolderEmployeeFilterInput.
| Name | Description |
|---|---|
and ([LicenseHolderEmployeeFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseHolderEmployeeFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
id (ComparableIdTypeOperationFilterInput) | |
name (StringOperationFilterInput) | |
email (StringOperationFilterInput) | |
groupIds (ListComparableIdTypeOperationFilterInput) | |
status (EmployeeStatusOperationFilterInput) | |
excludeFromFetch (BooleanOperationFilterInput) | |
userType (StringOperationFilterInput) | |
country (StringOperationFilterInput) | |
division (StringOperationFilterInput) | |
costCenter (StringOperationFilterInput) | |
departmentPath (StringListFilterInput) |
LicenseHolderFilterInput input
Input fields accepted by LicenseHolderFilterInput.
| Name | Description |
|---|---|
and ([LicenseHolderFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseHolderFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
name (StringOperationFilterInput) | |
email (StringOperationFilterInput) | |
external (ExternalUserFilterInput) | |
employee (LicenseHolderEmployeeFilterInput) |
LicenseHolderSortInput input
Input fields accepted by LicenseHolderSortInput.
| Name | Description |
|---|---|
name (SortEnumType) | |
email (SortEnumType) |
LicensePlanFilterInput input
Input fields accepted by LicensePlanFilterInput.
| Name | Description |
|---|---|
and ([LicensePlanFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicensePlanFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
id (ComparableIdTypeOperationFilterInput) | |
directIntegrationInstallationId (ComparableIdTypeOperationFilterInput) | |
externalKey (ExternalKeyFilterInput) | |
name (StringOperationFilterInput) | |
vendorId (ComparableIdTypeOperationFilterInput) | |
productId (ComparableIdTypeOperationFilterInput) | |
pricing (PricingModelFilterInput) | |
contractDetails (ContractDetailsFilterInput) | |
usageStats (LicensePlanUsageStatsFilterInput) | |
pricingStats (LicensePlanPricingStatsFilterInput) | |
originalPricingStats (LicensePlanPricingStatsFilterInput) |
LicensePlanFixedFeePricingComponentInput input
A fixed recurring charge billed at a set frequency, regardless of how many licenses are used.
| Name | Description |
|---|---|
billingFrequency (BillingFrequency!) | How often the fixed fee is charged, for example monthly or yearly. |
price (LicensePriceInput!) | The amount charged each billing period. |
LicensePlanPotentialSavingFilterInput input
Input fields accepted by LicensePlanPotentialSavingFilterInput.
| Name | Description |
|---|---|
and ([LicensePlanPotentialSavingFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicensePlanPotentialSavingFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
amount (FloatOperationFilterInput) | |
percentage (FloatOperationFilterInput) |
LicensePlanPotentialSavingSortInput input
Input fields accepted by LicensePlanPotentialSavingSortInput.
| Name | Description |
|---|---|
amount (SortEnumType) | |
percentage (SortEnumType) | |
rate (SortEnumType) |
LicensePlanPricingComponentInput input
A single pricing component to add to a plan's price list. Provide exactly one component type per entry.
| Name | Description |
|---|---|
fixedFee (LicensePlanFixedFeePricingComponentInput) | A fixed recurring charge billed at a set frequency. |
LicensePlanPricingStatsFilterInput input
Input fields accepted by LicensePlanPricingStatsFilterInput.
| Name | Description |
|---|---|
and ([LicensePlanPricingStatsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicensePlanPricingStatsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
currency (StringOperationFilterInput) | |
annualUnitPrice (FloatOperationFilterInput) | |
annualCost (FloatOperationFilterInput) | |
potentialSaving (LicensePlanPotentialSavingFilterInput) |
LicensePlanPricingStatsSortInput input
Input fields accepted by LicensePlanPricingStatsSortInput.
| Name | Description |
|---|---|
currency (SortEnumType) | |
annualUnitPrice (SortEnumType) | |
annualCost (SortEnumType) | |
potentialSaving (LicensePlanPotentialSavingSortInput) |
LicensePlanReducedModelFilterInput input
Input fields accepted by LicensePlanReducedModelFilterInput.
| Name | Description |
|---|---|
and ([LicensePlanReducedModelFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicensePlanReducedModelFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
id (ComparableIdTypeOperationFilterInput) | |
directIntegrationInstallationId (ComparableIdTypeOperationFilterInput) | |
name (StringOperationFilterInput) | |
vendorId (ComparableIdTypeOperationFilterInput) | |
pricing (PricingModelFilterInput) |
LicensePlanReducedModelSortInput input
Input fields accepted by LicensePlanReducedModelSortInput.
| Name | Description |
|---|---|
id (SortEnumType) | |
name (SortEnumType) |
LicensePlanSortInput input
Input fields accepted by LicensePlanSortInput.
| Name | Description |
|---|---|
name (SortEnumType) | |
contractDetails (ContractDetailsSortInput) | |
usageStats (LicensePlanUsageStatsSortInput) | |
pricingStats (LicensePlanPricingStatsSortInput) |
LicensePlanUsageStatsFilterInput input
Input fields accepted by LicensePlanUsageStatsFilterInput.
| Name | Description |
|---|---|
and ([LicensePlanUsageStatsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicensePlanUsageStatsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
inUse (InUseLicensePlanStatsFilterInput) | |
unused (UnusedLicensePlanStatsFilterInput) | |
noData (NoDataLicensePlanStatsFilterInput) | |
downgradable (DowngradableLicensePlanStatsFilterInput) | |
assigned (IntOperationFilterInput) | |
unassigned (IntOperationFilterInput) | |
wasted (IntOperationFilterInput) | |
total (IntOperationFilterInput) | |
effective (IntOperationFilterInput) | |
usageAvailability (UsageAvailabilityFilterInput) |
LicensePlanUsageStatsSortInput input
Input fields accepted by LicensePlanUsageStatsSortInput.
| Name | Description |
|---|---|
inUse (InUseLicensePlanStatsSortInput) | |
unused (UnusedLicensePlanStatsSortInput) | |
noData (NoDataLicensePlanStatsSortInput) | |
downgradable (DowngradableLicensePlanStatsSortInput) | |
assigned (SortEnumType) | |
unassigned (SortEnumType) | |
wasted (SortEnumType) | |
total (SortEnumType) | |
effective (SortEnumType) |
LicensePriceFilterInput input
Input fields accepted by LicensePriceFilterInput.
| Name | Description |
|---|---|
and ([LicensePriceFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicensePriceFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
amount (FloatOperationFilterInput) | |
isNullish (Boolean) | Matches when the field is null or missing (not present in the database). |
LicensePriceInput input
A monetary amount in a specific currency.
| Name | Description |
|---|---|
currency (String!) | Three-letter ISO currency code, such as USD or EUR. |
amount (Float!) | The amount of money. Must not be negative. |
LicensePriceSortInput input
Input fields accepted by LicensePriceSortInput.
| Name | Description |
|---|---|
amount (SortEnumType) |
LicenseReferenceTargetFilterInput input
Input fields accepted by LicenseReferenceTargetFilterInput.
| Name | Description |
|---|---|
and ([LicenseReferenceTargetFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseReferenceTargetFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
vendorId (EqualOnlyOperationFilterInputTypeOfIdTypeFilterInput) | |
productId (EqualOnlyOperationFilterInputTypeOfIdTypeFilterInput) | |
vendorName (StringOperationFilterInput) |
LicenseSortInput input
Input fields accepted by LicenseSortInput.
| Name | Description |
|---|---|
id (SortEnumType) | |
state (LicenseStateSortInput) | |
holder (LicenseHolderSortInput) | |
plan (LicensePlanReducedModelSortInput) | |
usage (LicenseUsageSortInput) | |
annualPrice (LicensePriceSortInput) | |
originalAnnualPrice (LicensePriceSortInput) | |
potentialSaving (LicensePriceSortInput) | |
originalPotentialSaving (LicensePriceSortInput) |
LicenseStateFilterInput input
Input fields accepted by LicenseStateFilterInput.
| Name | Description |
|---|---|
and ([LicenseStateFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseStateFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
activity (LicenseActivityOperationFilterInput) |
LicenseStateSortInput input
Input fields accepted by LicenseStateSortInput.
| Name | Description |
|---|---|
activity (SortEnumType) |
LicenseUsageFilterInput input
Input fields accepted by LicenseUsageFilterInput.
| Name | Description |
|---|---|
and ([LicenseUsageFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([LicenseUsageFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
detailedSources (ListLicenseDetailedSourceFilterInput) | |
lastUsed (DateOperationFilterInput) |
LicenseUsageSortInput input
Input fields accepted by LicenseUsageSortInput.
| Name | Description |
|---|---|
lastUsed (SortEnumType) |
LinkContractsInput input
The details needed to link a contract to other contracts.
| Name | Description |
|---|---|
contractId (ID!) | The identifier of the contract to add links to. |
links ([ContractLinkInput!]!) | The contracts to link, each with its link type. |
ListLicenseDetailedSourceFilterInput input
Input fields accepted by ListLicenseDetailedSourceFilterInput.
| Name | Description |
|---|---|
all (LicenseDetailedSourceFilterInput) | Matches when every element of the list satisfies the given filter. |
none (LicenseDetailedSourceFilterInput) | Matches when no element of the list satisfies the given filter. |
some (LicenseDetailedSourceFilterInput) | Matches when at least one element of the list satisfies the given filter. |
any (Boolean) | Matches when the list contains any elements (or none, when set to false). |
NoDataLicensePlanStatsFilterInput input
Input fields accepted by NoDataLicensePlanStatsFilterInput.
| Name | Description |
|---|---|
and ([NoDataLicensePlanStatsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([NoDataLicensePlanStatsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
newEmployee (IntOperationFilterInput) | |
noUsageDetected (IntOperationFilterInput) | |
total (IntOperationFilterInput) |
NoDataLicensePlanStatsSortInput input
Input fields accepted by NoDataLicensePlanStatsSortInput.
| Name | Description |
|---|---|
newEmployee (SortEnumType) | |
noUsageDetected (SortEnumType) | |
total (SortEnumType) |
NullableOfBillingFrequencyOperationFilterInput input
Input fields accepted by NullableOfBillingFrequencyOperationFilterInput.
| Name | Description |
|---|---|
eq (BillingFrequency) | Matches when the field value is exactly equal to the given value. |
neq (BillingFrequency) | Matches when the field value is not equal to the given value. |
in ([BillingFrequency]) | Matches when the field value is one of the values in the given list. |
nin ([BillingFrequency]) | Matches when the field value is none of the values in the given list. |
NullableOfContractStatusOperationFilterInput input
Input fields accepted by NullableOfContractStatusOperationFilterInput.
| Name | Description |
|---|---|
eq (ContractStatus) | Matches when the field value is exactly equal to the given value. |
neq (ContractStatus) | Matches when the field value is not equal to the given value. |
in ([ContractStatus]) | Matches when the field value is one of the values in the given list. |
nin ([ContractStatus]) | Matches when the field value is none of the values in the given list. |
OriginValueOfDateOnlyFilterInput input
Input fields accepted by OriginValueOfDateOnlyFilterInput.
| Name | Description |
|---|---|
and ([OriginValueOfDateOnlyFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([OriginValueOfDateOnlyFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
origin (DataOriginOperationFilterInput) | |
value (DateOperationFilterInput) |
OriginValueOfDateOnlySortInput input
Input fields accepted by OriginValueOfDateOnlySortInput.
| Name | Description |
|---|---|
origin (SortEnumType) | |
value (SortEnumType) |
OriginValueOfInt32SortInput input
Input fields accepted by OriginValueOfInt32SortInput.
| Name | Description |
|---|---|
origin (SortEnumType) | |
value (SortEnumType) |
PricingModelFilterInput input
Input fields accepted by PricingModelFilterInput.
| Name | Description |
|---|---|
and ([PricingModelFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([PricingModelFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
type (PricingModelTypeOperationFilterInput) |
PricingModelTypeOperationFilterInput input
Input fields accepted by PricingModelTypeOperationFilterInput.
| Name | Description |
|---|---|
eq (PricingModelType) | Matches when the field value is exactly equal to the given value. |
neq (PricingModelType) | Matches when the field value is not equal to the given value. |
in ([PricingModelType]) | Matches when the field value is one of the values in the given list. |
nin ([PricingModelType]) | Matches when the field value is none of the values in the given list. |
ReferenceTargetInput input
A reference to either a vendor or a product. Provide exactly one.
| Name | Description |
|---|---|
vendorId (ID) | The identifier of the vendor. |
productId (ID) | The identifier of the product. |
StringListFilterInput input
Input fields accepted by StringListFilterInput.
| Name | Description |
|---|---|
all (StringOperationFilterInput) | Matches when every element of the list satisfies the given filter. |
none (StringOperationFilterInput) | Matches when no element of the list satisfies the given filter. |
some (StringOperationFilterInput) | Matches when at least one element of the list satisfies the given filter. |
any (Boolean) | Matches when the list contains any elements (or none, when set to false). |
startsWith ([String!]) | Matches when the list of strings starts with the given segments. For example, "A", "B" matches "A", "B", "C". |
nstartsWith ([String!]) | Matches when the list of strings does not start with the given segments. |
UnlinkContractsInput input
The details needed to remove links between contracts.
| Name | Description |
|---|---|
contractId (ID!) | The identifier of the contract to remove links from. |
linkedContractIds ([ID!]!) | The identifiers of the linked contracts to unlink. |
UnusedLicensePlanStatsFilterInput input
Input fields accepted by UnusedLicensePlanStatsFilterInput.
| Name | Description |
|---|---|
and ([UnusedLicensePlanStatsFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([UnusedLicensePlanStatsFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
noRecentUsage (IntOperationFilterInput) | |
noSsoLogin (IntOperationFilterInput) | |
leftOrganization (IntOperationFilterInput) | |
total (IntOperationFilterInput) |
UnusedLicensePlanStatsSortInput input
Input fields accepted by UnusedLicensePlanStatsSortInput.
| Name | Description |
|---|---|
noRecentUsage (SortEnumType) | |
noSsoLogin (SortEnumType) | |
leftOrganization (SortEnumType) | |
total (SortEnumType) |
UpdateContractDatesAndTermsInput input
The details needed to change a contract's dates and renewal terms.
| Name | Description |
|---|---|
id (ID!) | The identifier of the contract to update. |
startDate (Date) | The date the contract starts. Leave empty to clear it. |
endDate (Date) | The date the contract ends. Leave empty to clear it. |
termInMonths (Int) | The duration of the contract in months. Leave empty to clear it. |
autoRenewEnabled (Boolean!) | Whether the contract renews automatically. |
noticePeriodInDays (Int) | How many days of notice are required to cancel before the contract renews. Leave empty to clear it. |
UpdateContractNameInput input
The details needed to rename a contract.
| Name | Description |
|---|---|
id (ID!) | The identifier of the contract to update. |
name (String!) | The new name for the contract. |
UpdateContractNumberInput input
The details needed to change a contract's number.
| Name | Description |
|---|---|
id (ID!) | The identifier of the contract to update. |
contractNumber (String) | The new contract number. Leave empty to clear it. |
UpdateContractPaymentTermsInput input
The details needed to change a contract's value and payment terms.
| Name | Description |
|---|---|
id (ID!) | The identifier of the contract to update. |
totalContractValue (ContractPriceInput) | The total value of the contract. Leave empty to clear it. |
billingFrequency (BillingFrequency) | How often the contract is billed. Leave empty to clear it. |
paymentTerms (String) | The payment terms agreed with the supplier. Leave empty to clear them. |
UpdateContractReferenceTargetInput input
The details needed to change the vendor or product a contract applies to.
| Name | Description |
|---|---|
id (ID!) | The identifier of the contract to update. |
reference (ReferenceTargetInput) | The vendor or product the contract applies to. Leave empty to clear the scope. |
UpdateContractsOwnerInput input
The details needed to change the owner of contracts.
| Name | Description |
|---|---|
ownerId (ID) | The identifier of the employee who owns the contracts. Leave empty to unset the owner. |
UpdateContractSupplierInput input
The details needed to change a contract's supplier.
| Name | Description |
|---|---|
id (ID!) | The identifier of the contract to update. |
supplier (String) | The new supplier. Leave empty to clear it. |
UsageAvailabilityFilterInput input
Input fields accepted by UsageAvailabilityFilterInput.
| Name | Description |
|---|---|
and ([UsageAvailabilityFilterInput!]) | Matches when every one of the given filter expressions matches (logical AND). |
or ([UsageAvailabilityFilterInput!]) | Matches when at least one of the given filter expressions matches (logical OR). |
status (UsageAvailabilityStatusOperationFilterInput) |
UsageAvailabilityStatusOperationFilterInput input
Input fields accepted by UsageAvailabilityStatusOperationFilterInput.
| Name | Description |
|---|---|
eq (UsageAvailabilityStatus) | Matches when the field value is exactly equal to the given value. |
neq (UsageAvailabilityStatus) | Matches when the field value is not equal to the given value. |
in ([UsageAvailabilityStatus!]) | Matches when the field value is one of the values in the given list. |
nin ([UsageAvailabilityStatus!]) | Matches when the field value is none of the values in the given list. |
Unions
AggregatedLicensePlansCriteria union
Possible object types returned by the AggregatedLicensePlansCriteria union.
Possible types: AggregatedLicensePlansProductCriteria, AggregatedLicensePlansVendorCriteria, AggregatedLicensePlansIntegrationCriteria, AggregatedLicensePlansAttributeCriteria
ContractReferenceTarget union
The vendor or product a contract applies to.
Possible types: VendorReference, ProductReference
CreateContractError union
A reason a contract could not be created.
Possible types: VendorNotFoundError, ProductNotFoundError, InvalidContractDateError
CreateManualLicensePlanError union
A reason a license plan could not be created.
Possible types: VendorNotFoundError, ProductNotFoundError, IntegratedLicensePlanExistsError
IntegrationLicenseDetails union
Possible object types returned by the IntegrationLicenseDetails union.
Possible types: UnknownIntegrationLicenseDetails, FreeIntegrationLicenseDetails, FlatFeeIntegrationLicenseDetails, PerLicenseIntegrationLicenseDetails, BulkIntegrationLicenseDetails, StairStepIntegrationLicenseDetails, VolumeIntegrationLicenseDetails
LicenseAnalyticsBucketKey union
Possible object types returned by the LicenseAnalyticsBucketKey union.
Possible types: VendorBucketKey, ProductBucketKey, PlanBucketKey, StateBucketKey, StateReasonBucketKey, PricingModelBucketKey, EmployeeStatusBucketKey, DivisionBucketKey, CostCenterBucketKey, CountryBucketKey
LicenseDowngradeReason union
Possible object types returned by the LicenseDowngradeReason union.
Possible types: LicenseDowngradeNoUsageReason, LicenseDowngradeExclusiveUsageReason
LicensePlan union
Possible object types returned by the LicensePlan union.
Possible types: ManualLicensePlan, IntegratedLicensePlan
LicensePlanPricingComponent union
One part of how a license plan is priced. A plan's price list is made up of one or more of these components.
Possible types: LicensePlanFixedFeePricingComponent
LicenseReferenceTarget union
Possible object types returned by the LicenseReferenceTarget union.
Possible types: VendorReference, ProductReference
LicenseState union
Possible object types returned by the LicenseState union.
Possible types: InUseLicenseState, UnusedLicenseState, NoDataLicenseState, DowngradableLicenseState
LinkContractsError union
A reason contracts could not be linked.
Possible types: ContractNotFoundError
PricingModel union
Possible object types returned by the PricingModel union.
Possible types: UnknownPricingModel, FreePricingModel, FlatFeePricingModel, PerLicensePricingModel, BulkPricingModel, StairStepPricingModel, VolumePricingModel
UnlinkContractsError union
A reason contract links could not be removed.
Possible types: ContractNotFoundError
UpdateContractDatesAndTermsError union
A reason a contract's dates and terms could not be changed.
Possible types: ContractNotFoundError
UpdateContractNameError union
A reason a contract's name could not be changed.
Possible types: ContractNotFoundError
UpdateContractNumberError union
A reason a contract's number could not be changed.
Possible types: ContractNotFoundError
UpdateContractPaymentTermsError union
A reason a contract's value and payment terms could not be changed.
Possible types: ContractNotFoundError
UpdateContractReferenceTargetError union
A reason a contract's vendor or product could not be changed.
Possible types: VendorNotFoundError, ProductNotFoundError, ContractNotFoundError
UpdateContractSupplierError union
A reason a contract's supplier could not be changed.
Possible types: ContractNotFoundError
Enums
BillingFrequency enum
How often a contract is billed.
| Value | Description |
|---|---|
ONCE | Billed a single time. |
MONTHLY | Billed every month. |
QUARTERLY | Billed every three months. |
SEMIANNUAL | Billed every six months. |
YEARLY | Billed every year. |
DAILY | |
WEEKLY |
ContractLinkType enum
How one contract is linked to another.
| Value | Description |
|---|---|
SUPERSEDES | This contract replaces the linked contract. |
RELATED_TO | This contract is related to the other contract without replacing it. |
ContractStatus enum
The lifecycle status of a contract.
| Value | Description |
|---|---|
UPCOMING | The contract has not started yet. |
ACTIVE | The contract is currently in effect. |
EXPIRED | The contract has ended. |
CountCalculationType enum
Count calculation type
| Value | Description |
|---|---|
AUTOMATIC | Calculate value based on statistics |
MANUAL | Use manually entered value |
DataOrigin enum
Accepted values for the DataOrigin enum.
| Value | Description |
|---|---|
API | |
AUTO | |
MANUAL |
InUseLicenseStateReason enum
Accepted values for the InUseLicenseStateReason enum.
| Value | Description |
|---|---|
HAS_RECENT_USAGE | |
SSO_LOGIN | |
EXCLUDED_FROM_ANALYSIS |
LicenseActivity enum
Accepted values for the LicenseActivity enum.
| Value | Description |
|---|---|
IN_USE | |
UNUSED | |
NO_DATA | |
DOWNGRADABLE |
LicenseAnalyticsDimension enum
Accepted values for the LicenseAnalyticsDimension enum.
| Value | Description |
|---|---|
VENDOR | |
REFERENCE | |
PLAN | |
STATE | |
STATE_REASON | |
PRICING_MODEL | |
DIVISION | |
COST_CENTER | |
COUNTRY | |
EMPLOYEE_STATUS |
LicensePlanGroupingAttribute enum
Accepted values for the LicensePlanGroupingAttribute enum.
| Value | Description |
|---|---|
ORGANIZATION |
LicensePlanOrigin enum
Where a license plan came from.
| Value | Description |
|---|---|
INTEGRATION | The plan was discovered automatically through a connected integration. |
MANUAL | The plan was created manually. |
LicensePlanPotentialSavingRate enum
Accepted values for the LicensePlanPotentialSavingRate enum.
| Value | Description |
|---|---|
NONE | |
LOW | |
MEDIUM | |
HIGH |
NoDataLicenseStateReason enum
Accepted values for the NoDataLicenseStateReason enum.
| Value | Description |
|---|---|
NEW_EMPLOYEE | |
NO_USAGE_DETECTED |
PlanType enum
Accepted values for the PlanType enum.
| Value | Description |
|---|---|
MANUAL | |
AUTO |
PricingModelType enum
Accepted values for the PricingModelType enum.
| Value | Description |
|---|---|
UNKNOWN | |
FREE | |
FLAT_FEE | |
PER_LICENSE | |
BULK | |
STAIR_STEP | |
VOLUME |
UnusedLicenseStateReason enum
Accepted values for the UnusedLicenseStateReason enum.
| Value | Description |
|---|---|
NO_RECENT_USAGE | |
NO_SSO_LOGIN | |
LEFT_ORGANIZATION |
UsageAvailabilityStatus enum
Accepted values for the UsageAvailabilityStatus enum.
| Value | Description |
|---|---|
AVAILABLE | |
NOT_SUPPORTED |