Update a subscription type

Updates a subscription type by the given Id.

put

Path parameters

idstringRequired

The id of the subscription type.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

Auth-Key is required to authenticate the request. If missing, the server will return 401 Unauthorized.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

This class is used to define the data transfer object for the SubscriptionType which is used to create or update a subscription type.

namestring · min: 1Required

The name of the subscription type.

unitstring · enumRequired

Represents the unit of time used for a subscription period.

Possible values:

quantityinteger · int32Optional

The quantity of the subscription type.

tagsstring | nullableOptional

The tags of the subscription type.

zOrderinteger · int64 | nullableOptional

The z-order of the subscription type. If the value not provide, we will set the new z-order base on the current item's brand.

statusstring · enumOptional

This enum is used to define the common status of an object in JFW.

Supported values:

Possible values:

isDefaultbooleanOptional

Flag to indicate if the subscription type is default. By default, it is false.

descriptionstring | nullableOptional

The description of the subscription type.

Responses

200

The request was successful.

application/json

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

put

HTTPcURLJavaScriptPython

PUT /api/v1/subscription-types/{id} HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "name": "text",
  "unit": "Hour",
  "quantity": 1,
  "tags": "text",
  "zOrder": 1,
  "status": "Inactive",
  "isDefault": true,
  "description": "text"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "id": "sApKpllz4sAplsmzha",
    "name": "Example Subscription Type",
    "unit": "Day",
    "quantity": 1,
    "tags": "Example Tags",
    "zOrder": 1,
    "status": "Active",
    "isDefault": true,
    "description": "Example Description"
  },
  "errors": []
}