API Reference

REST API endpoints for plugins, subscriptions, licenses, webhooks, authentication, and error handling.

Last updated: 16 مارس 2026

API Overview

The Dryade REST API provides programmatic access to platform features. All endpoints are served over HTTPS and require authentication.

Base URL: https://your-dryade-instance/api

Authentication

Dryade uses JWT bearer tokens for API authentication:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-instance/api/plugins

Tokens are obtained via the /api/auth/login endpoint or through SSO/SAML integration (Enterprise tier).

Core Endpoints

Plugins

MethodEndpointDescription
GET/api/pluginsList installed plugins
GET/api/plugins/:slugGet plugin details
POST/api/plugins/:slug/installInstall a plugin
DELETE/api/plugins/:slugUninstall a plugin

Agents

MethodEndpointDescription
GET/api/agentsList registered agents
GET/api/agents/:idGet agent details
POST/api/agents/:id/executeExecute an agent
GET/api/agents/:id/historyGet execution history

Workflows

MethodEndpointDescription
GET/api/workflowsList workflows
POST/api/workflowsCreate a workflow
POST/api/workflows/:id/runExecute a workflow
GET/api/workflows/:id/runsGet run history

Error Handling

All errors return a consistent JSON structure:

{
  "error": {
    "code": "PLUGIN_NOT_FOUND",
    "message": "Plugin 'my-plugin' is not installed",
    "status": 404
  }
}

See the Errors reference for the complete error code catalog.

Rate Limits

  • Starter: 100 requests/minute
  • Team: 500 requests/minute
  • Enterprise: Configurable

Interactive API Reference

For a complete interactive API reference with live code examples, visit the API Explorer.