Method: accounts.customers.entitlements.changeSeats

Updates the seat counts for existing seat-based entitlements.

An entitlement update is a long running operation and results in updates to entitlement as a result of fulfillment.

HTTP request

POST https://cloudchannel.googleapis.com/v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changeSeats

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the entitlement to update. The name takes the format: 'accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}'

Request body

The request body contains data with the following structure:

JSON representation 
{
  "quantity": number,
  "externalCorrelationId": string
}
Fields
quantity

number

New seat count for commitment-based entitlements, as well as Flex or Trial-based entitlements.

externalCorrelationId

string

An optional identifier in the external system that partners can use to correlate a Channel Services purchase transaction for the entitlement.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/userinfo.email

For more information, see the Authentication Overview.

Try it!