Skip to main content
PATCH
/
catalog
/
plans
/
{identifier}
Update a plan
curl --request PATCH \
  --url https://api.kelviq.com/api/v1/catalog/plans/{identifier}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Pro Monthly (v2)",
  "description": "Updated description.",
  "metadata": {},
  "isVisible": true,
  "license": {
    "enabled": true,
    "activationLimit": 3,
    "activationLimitEnabled": true,
    "durationUnit": "YEAR",
    "durationValue": 1,
    "hasExpiry": true
  },
  "links": [
    {
      "name": "Product page",
      "url": "https://example.com/product"
    }
  ],
  "fileKeys": [
    "tmp/9b1c8af2-3d4e-4f9a-8b2c-1f3e5a7b9d12/plan-terms.pdf"
  ]
}
'
{
  "identifier": "pro-monthly",
  "name": "Pro Monthly",
  "description": "Pro tier billed monthly.",
  "product": "0d65f7c0-7e91-4f56-9b32-13a9a6a7c1de",
  "metadata": {},
  "version": 3,
  "isLatest": true,
  "modifiedOn": "2025-04-12T08:21:14.910Z",
  "createdOn": "2025-03-01T08:21:14.910Z",
  "details": {
    "stripeProductId": "prod_ABC123"
  },
  "isVisible": true,
  "isImported": false,
  "countries": [
    "US",
    "IN"
  ],
  "license": {
    "enabled": true,
    "activationLimit": 3,
    "activationLimitEnabled": true,
    "durationUnit": "YEAR",
    "durationValue": 1,
    "hasExpiry": true
  },
  "links": [
    {
      "name": "Product page",
      "url": "https://example.com/product"
    }
  ],
  "files": [
    {
      "id": "7a3e3411-cef0-4f4e-bdb6-1f74a4f4d2c0",
      "name": "Plan Terms.pdf",
      "file": "media/.../plans/<id>/<uuid>/terms.pdf",
      "ordering": 0,
      "enabled": true,
      "downloadUrl": "https://api.kelviq.com/api/v1/catalog/plans/pro-monthly/file/7a3e3411-cef0-4f4e-bdb6-1f74a4f4d2c0/download/"
    }
  ],
  "ordering": 1
}

Authorizations

​
Authorization
string
header
required

The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'

Path Parameters

​
identifier
string
required

Plan identifier (slug). Stable across versions.

Query Parameters

​
version
integer

Specific version number to fetch / update. Defaults to the latest version.

Body

application/json

Patch payload for a plan. If applied to a published (is_latest) plan, a new version is created automatically.

​
name
string
Example:

"Pro Monthly (v2)"

​
description
string
Example:

"Updated description."

​
metadata
object
Example:
{}
​
isVisible
boolean
Example:

true

​
license
object

License configuration for a plan (used when issuing license keys).

​
links
object[]
​
fileKeys
string[]

Additional temporary S3 keys (from POST /media/) to append to the plan's files. Existing files are left untouched.

Example:
[
  "tmp/9b1c8af2-3d4e-4f9a-8b2c-1f3e5a7b9d12/plan-terms.pdf"
]

Response

Updated plan.

A versioned plan attached to a product. Updates create new versions; only the published version is is_latest=true.

​
identifier
string

URL-safe slug. Stable across versions.

Example:

"pro-monthly"

​
name
string
Example:

"Pro Monthly"

​
description
string
Example:

"Pro tier billed monthly."

​
product
string<uuid>

UUID of the parent product.

Example:

"0d65f7c0-7e91-4f56-9b32-13a9a6a7c1de"

​
metadata
object
Example:
{}
​
version
integer
read-only
Example:

3

​
isLatest
boolean
read-only

True only for the currently published version.

Example:

true

​
modifiedOn
string<date-time>
read-only
Example:

"2025-04-12T08:21:14.910Z"

​
createdOn
string<date-time>
read-only
Example:

"2025-03-01T08:21:14.910Z"

​
details
object
read-only

Provider-side identifiers (e.g. stripeProductId).

Example:
{ "stripeProductId": "prod_ABC123" }
​
isVisible
boolean
Example:

true

​
isImported
boolean
read-only
Example:

false

​
countries
string[]
read-only
Example:
["US", "IN"]
​
license
object

License configuration for a plan (used when issuing license keys).

​
links
object[]
​
files
object[]
read-only
​
ordering
integer | null
Example:

1