Plugin Subscriptions

Update plugin subscription

PUT

http://localhost:3000/api/plugins/{pluginId}/subscriptions/{id}

curl -X PUT 'http://localhost:3000/api/plugins/%7BpluginId%7D/subscriptions/string' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "status": "active",
  "startDate": "string",
  "endDate": "string",
  "trialEndDate": "string",
  "autoRenew": true,
  "metadata": {}
}'

const body = `{
  "status": "active",
  "startDate": "string",
  "endDate": "string",
  "trialEndDate": "string",
  "autoRenew": true,
  "metadata": {}
}`;

const response = await fetch('http://localhost:3000/api/plugins/%7BpluginId%7D/subscriptions/string', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "status": "active",
  "startDate": "string",
  "endDate": "string",
  "trialEndDate": "string",
  "autoRenew": true,
  "metadata": {}
}'''

response = requests.put(
    'http://localhost:3000/api/plugins/%7BpluginId%7D/subscriptions/string',
    data=body.encode('utf-8'),
    headers={
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "status": "active",
  "startDate": "string",
  "endDate": "string",
  "trialEndDate": "string",
  "autoRenew": true,
  "metadata": {}
}

200

{
  "deletedAt": "2018-11-21T06:20:32.232Z",
  "createdAt": "2018-11-21T06:20:32.232Z",
  "updatedAt": "2018-11-21T06:20:32.232Z",
  "id": "string",
  "isActive": true,
  "isArchived": false,
  "archivedAt": "2018-11-21T06:20:32.232Z",
  "tenantId": "string",
  "organizationId": "string",
  "status": "active",
  "scope": "tenant",
  "startDate": "2024-01-15T09:30:00Z",
  "endDate": "2024-01-15T09:30:00Z",
  "trialEndDate": "2024-01-15T09:30:00Z",
  "autoRenew": true,
  "cancelledAt": "2024-01-15T09:30:00Z",
  "cancellationReason": "string",
  "metadata": {},
  "externalSubscriptionId": "string",
  "pluginId": "string",
  "pluginTenantId": "string",
  "planId": "string",
  "subscriberId": "string",
  "parentId": "string",
  "children": [],
  "billings": [
    "string"
  ]
}

Body

application/json

statusstringactivecancelledexpiredtrialpast_duesuspendedpending

Subscription status

startDatestring

Subscription start date

endDatestring

Subscription end date

trialEndDatestring

Trial end date

autoRenewboolean

Auto-renewal enabled

metadataobject

Subscription metadata

Parameters

idstringrequiredpath

Plugin subscription ID

Response

200OKPluginSubscription_1

Plugin subscription updated successfully

Response fields application/json

deletedAtstring<date-time>

Example

2018-11-21T06:20:32.232Z

createdAtstring<date-time>

The creation timestamp of the entity.

Example

2018-11-21T06:20:32.232Z

updatedAtstring<date-time>

The last update timestamp of the entity.

Example

2018-11-21T06:20:32.232Z

idstring

isActivebooleantrue

isArchivedbooleanfalse

archivedAtstring<date-time>

Example

2018-11-21T06:20:32.232Z

tenantIdstring

organizationIdstring

statusstringactivecancelledexpiredtrialpast_duesuspendedpendingrequired

Subscription status

scopestringtenantorganizationuserrequired

Subscription scope

startDatestring<date-time>required

Start date of subscription

endDatestring<date-time>

End date of subscription

trialEndDatestring<date-time>

Trial end date

autoRenewbooleanrequired

Whether auto-renewal is enabled

cancelledAtstring<date-time>

Cancellation date

cancellationReasonstring

Cancellation reason

metadataobject

Subscription metadata for additional data

externalSubscriptionIdstring

External subscription ID from payment provider

pluginIdstringrequired

Plugin ID

pluginTenantIdstringrequired

Plugin Tenant ID

planIdstring

Subscription plan ID

subscriberIdstring

Subscriber user ID for user-specific subscriptions

parentIdstring

Parent subscription ID for hierarchical subscriptions

parentPluginSubscription_1

Parent subscription (for subscriptions created through assignment)

Show child attributes

PluginSubscription_1

childrenArray<PluginSubscription_1>

Child subscriptions (user subscriptions created through assignment)

Same fields as PluginSubscription_1

billingsArray<string>

Plugin billings for this subscription

Stack Overflow Website Demo