Skip to main content
PUT
/
licenses
/
{licenseId}
/
product-offering-change
{
  "licenseId": "<string>",
  "status": "PENDING",
  "type": "<string>",
  "customerId": "<string>",
  "customer": {
    "customerId": "<string>",
    "name": "<string>"
  },
  "productOfferingId": "<string>",
  "productOffering": {
    "productOfferingId": "<string>",
    "name": "<string>",
    "price": {
      "grossPrice": 10,
      "discount": 123,
      "netPrice": 5,
      "currency": "USD",
      "priceType": "ONE_TIME",
      "boundMonths": 12,
      "billingCycle": {
        "period": "MONTHLY",
        "interval": 1
      },
      "taxIncluded": true
    },
    "productOfferingGroupId": "<string>",
    "group": {
      "productOfferingGroupId": "<string>",
      "name": "<string>",
      "category": "SUBSCRIPTION_CELL"
    }
  },
  "assignedTo": {
    "type": "SUBSCRIPTION",
    "subscriptionId": "<string>",
    "subscriptionDisplay": "<string>"
  },
  "details": {},
  "pendingStatus": {
    "status": "PENDING",
    "scheduledAt": "2023-12-25"
  },
  "pendingProductOffering": {
    "scheduledAt": "2023-12-25",
    "productOfferingId": "<string>",
    "name": "<string>",
    "price": {
      "grossPrice": 10,
      "discount": 123,
      "netPrice": 5,
      "currency": "USD",
      "priceType": "ONE_TIME",
      "boundMonths": 12,
      "billingCycle": {
        "period": "MONTHLY",
        "interval": 1
      },
      "taxIncluded": true
    },
    "productOfferingGroupId": "<string>",
    "group": {
      "productOfferingGroupId": "<string>",
      "name": "<string>",
      "category": "SUBSCRIPTION_CELL"
    }
  },
  "activatedAt": "2023-11-07T05:31:56Z",
  "cancelledAt": "2023-11-07T05:31:56Z",
  "pausedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "metadata": {}
}

Authorizations

​
X-API-Key
string
header
required

An API key that grants access to the Connect API. You can create and manage API keys in the portal.

Headers

​
X-Idempotency-Key
string

A unique key to ensure idempotency of requests. If a request with the same key has already been processed, the same result will be returned. The key must be unique for each distinct operation. Keys are expired after 24 hours, but we recommend using a new key for each request.

Modified requests with the same idempotency keys are rejected with a 409 Conflict status code.

Maximum length: 256

Path Parameters

​
licenseId
string
required

The unique identifier of the license.

Body

application/json

The product offering change request.

Request to change the product offering of a license.

​
productOfferingId
string
required

The unique identifier of the new product offering.

​
scheduleDate
string<date>

Earliest date to perform the change on. If the change schedule doesn't fit this date, the earliest date after this will be chosen.

Example:

"2024-02-01"

​
metadata
object

A set of key-value pairs that can be attached to an object for storing additional information in a semi-structured format.

Response

Product offering change scheduled.

A license represents a permission to use a software product with embedded customer and product offering details.

​
licenseId
string
required

The unique identifier for the license.

​
status
enum<string>
required

The status of the license.

Available options:
PENDING,
ACTIVE,
PAUSED,
CANCELLED,
BLOCKED
​
type
string
required

The type of license, categorizing the software product or service into various telecommunications license types.

​
customer
object
required

Customer information embedded in responses. Sensitive details require separate API calls with appropriate authorization.

​
productOffering
object
required

Embedded representation of a product offering.

​
activatedAt
string<date-time>
required

The date and time when the license was activated.

​
createdAt
string<date-time>
required

The date and time when the license was created.

​
updatedAt
string<date-time>
required

The date and time when the license was last updated.

​
customerId
string

The unique identifier for the customer.

​
productOfferingId
string

The unique identifier for the product offering.

​
assignedTo
object

Assignment details for a license, indicating what entity the license is assigned to. This embedded version includes additional display information for each assignment type.

License assigned to a subscription

​
details
object

Additional license details specific to certain license types.

​
pendingStatus
object

Details about when a pending status change is scheduled for this license.

​
pendingProductOffering
object

Embedded representation of a product offering.

​
cancelledAt
string<date-time>

The date and time when the license was cancelled (if applicable).

​
pausedAt
string<date-time>

The date and time when the license was paused (if applicable).

​
metadata
object

A set of key-value pairs that can be attached to an object for storing additional information in a semi-structured format.

⌘I