Plugins API

Browse, search, and retrieve plugin information from the marketplace.

List and Search Plugins

GET /plugins

Parameters:

Name	Type	Required	Description
search	string	No	Search query for plugin name/description
tier	string	No	Filter by tier (starter, team, enterprise)
type	string	No	Filter by plugin type
category	string	No	Filter by category
page	integer	No	Page number (default: 1)
limit	integer	No	Results per page (default: 20, max: 100)

Response:

{
  "data": [
    {
      "id": "plugin_abc123",
      "name": "Workflow Automator",
      "slug": "workflow-automator",
      "description": "Automate complex workflows with ease",
      "category": "automation",
      "min_tier": "team",
      "pricing_type": "subscription",
      "price_monthly": 9.99,
      "rating_avg": 4.8,
      "download_count": 1250
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 156,
    "total_pages": 8
  }
}

Get Plugin Details

GET /plugins/:id

Parameters:

Name	Type	Required	Description
id	string	Yes	Plugin ID or slug

Response:

{
  "id": "plugin_abc123",
  "name": "Workflow Automator",
  "slug": "workflow-automator",
  "description": "Automate complex workflows with ease",
  "long_description": "Full markdown description...",
  "category": "automation",
  "min_tier": "team",
  "pricing_type": "subscription",
  "price_monthly": 9.99,
  "publisher": {
    "id": "pub_xyz789",
    "display_name": "Acme Tools",
    "verified": true
  },
  "current_version": "2.1.0",
  "rating_avg": 4.8,
  "rating_count": 89,
  "download_count": 1250,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-12-01T14:20:00Z"
}

Get Plugin Version History

GET /plugins/:id/versions

Parameters:

Name	Type	Required	Description
id	string	Yes	Plugin ID or slug

Response:

{
  "data": [
    {
      "version": "2.1.0",
      "changelog": "- Added new automation triggers\n- Fixed memory leak",
      "min_dryade_version": "1.5.0",
      "published_at": "2024-12-01T14:20:00Z"
    },
    {
      "version": "2.0.0",
      "changelog": "- Major rewrite with improved performance",
      "min_dryade_version": "1.4.0",
      "published_at": "2024-10-15T09:00:00Z"
    }
  ]
}