Subscriptions API

Manage your subscription and installed plugins.

Get Subscription Info

GET /subscription

Response:

{
  "tier": "team",
  "status": "active",
  "seats_total": 5,
  "seats_used": 3,
  "valid_from": "2024-01-01T00:00:00Z",
  "valid_until": "2025-01-01T00:00:00Z",
  "stripe_subscription_id": "sub_xxx"
}

List Installed Plugins

GET /plugins/installed

Response:

{
  "data": [
    {
      "plugin_id": "plugin_abc123",
      "plugin_name": "Workflow Automator",
      "version": "2.1.0",
      "installed_at": "2024-11-20T10:00:00Z",
      "auto_update": true
    }
  ]
}

Install a Plugin

POST /plugins/:id/install

Parameters:

Name	Type	Required	Description
id	string	Yes	Plugin ID
version	string	No	Specific version (default: latest)

Request Body:

{
  "version": "2.1.0",
  "auto_update": true
}

Response:

{
  "success": true,
  "plugin_id": "plugin_abc123",
  "version": "2.1.0",
  "installed_at": "2024-12-05T15:30:00Z"
}

Uninstall a Plugin

DELETE /plugins/:id/install

Note: Triggers plugin.uninstalled webhook for Enterprise subscribers.

Parameters:

Name	Type	Required	Description
id	string	Yes	Plugin ID

Response:

{
  "success": true,
  "plugin_id": "plugin_abc123",
  "uninstalled_at": "2024-12-05T15:35:00Z"
}