Update Package

PATCH

/api/:account_id/packages/:package_id

PATCH

/api/:account_id/packages/:package_id

$ curl -X PATCH https://app.paymentkit.com/api/account_id/packages/package_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "id": "pkg_9f8b7c6d5e4a3b2c1d0e",
3   "account_id": "acc_1234567890abcdef",
4   "name": "Premium Subscription",
5   "created_at": "2024-01-15T09:30:00Z",
6   "updated_at": "2024-01-15T09:30:00Z",
7   "description": "Access to all premium features and priority support.",
8   "is_active": true,
9   "allow_monthly": true,
10   "allow_annual": true,
11   "default_billing_cycle": "monthly",
12   "items": [
13     {
14       "id": "item_abcdef1234567890",
15       "package_id": "pkg_9f8b7c6d5e4a3b2c1d0e",
16       "product_id": "prod_9876543210fedcba",
17       "created_at": "2024-01-15T09:30:00Z",
18       "updated_at": "2024-01-15T09:30:00Z",
19       "product_name": "Cloud Storage 1TB",
20       "prices": [
21         {
22           "price_id": "price_monthly_001",
23           "is_default": true,
24           "name": "Monthly Plan",
25           "unit_amount_atom": 999,
26           "currency": "usd",
27           "recurring_interval": "month",
28           "recurring_interval_count": 1,
29           "billing_scheme": "per_unit",
30           "usage_type": "licensed"
31         },
32         {
33           "price_id": "price_annual_001",
34           "is_default": false,
35           "name": "Annual Plan",
36           "unit_amount_atom": 9999,
37           "currency": "usd",
38           "recurring_interval": "year",
39           "recurring_interval_count": 1,
40           "billing_scheme": "per_unit",
41           "usage_type": "licensed"
42         }
43       ],
44       "monthly_price_id": "price_monthly_001",
45       "annual_price_id": "price_annual_001",
46       "quantity": 1,
47       "description": "Includes 1TB of cloud storage space."
48     }
49   ],
50   "deleted_at": "2024-01-15T09:30:00Z"
51 }

Update a package. If items are provided, they replace all existing items.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

package_idstringRequired

account_idstringRequired

Request

This endpoint expects an object.

namestring or nullOptional>=1 character

Package name

descriptionstring or nullOptional

Package description

is_activeboolean or nullOptional

Whether the package is active

allow_monthlyboolean or nullOptional

Allow monthly billing cycle

allow_annualboolean or nullOptional

Allow annual billing cycle

default_billing_cycleenum or nullOptional

Default billing cycle

itemslist of objects or nullOptional

Replace all package items

metadatamap from strings to any or nullOptional

Optional metadata

Response

Successful Response

idstring

account_idstring

namestring

created_atdatetime

updated_atdatetime

descriptionstring or nullOptional

is_activebooleanOptionalDefaults to true

allow_monthlybooleanOptionalDefaults to true

allow_annualbooleanOptionalDefaults to true

default_billing_cyclestringOptionalDefaults to monthly

itemslist of objectsOptional

deleted_atdatetime or nullOptional

Errors

422

Unprocessable Entity Error