Plugins API

GET /api/v1/plugins — list active plugins with auth methods, tool counts, categories, and optional connection status.

List Plugins

GET /api/v1/plugins

Returns all active and approved plugins with their auth methods, tool counts, and categories. Only plugins with status = "active" and reviewStatus = "approved" are included — draft, pending, or declined plugins are never exposed through this endpoint.

Authentication

API key required: Authorization: Bearer nk_live_...

Query Parameters

Parameter	Type	Required	Description
`userId`	string	No	If provided, includes `connected: true/false` for this user
`limit`	number	No	Enables pagination and returns up to this many plugins. Maximum: `100`
`cursor`	string	No	Opaque cursor from the previous response
`connectedFirst`	boolean	No	When `true` and `userId` is provided, connected plugins are sorted first

Response

{
  "plugins": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "gmail",
      "name": "Gmail",
      "description": "Send and manage emails via Gmail API",
      "iconUrl": "https://example.com/gmail-icon.png",
      "pluginPrompt": "When using Gmail tools, always confirm the recipient before sending.",
      "status": "active",
      "authMethods": [
        {
          "type": "oauth2",
          "label": "Google OAuth",
          "isDefault": true
        }
      ],
      "categories": [
        { "slug": "messaging", "name": "Messaging" }
      ],
      "toolCount": 5,
      "connected": true
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjMwfQ",
  "hasMore": true
}

Response Fields

Field	Type	Description
`id`	string	Plugin UUID
`slug`	string	Unique identifier used in SDK calls
`name`	string	Display name
`description`	string or null	Plugin description
`iconUrl`	string or null	Icon URL
`pluginPrompt`	string or null	Optional LLM context prompt
`status`	string	Always `"active"` (only active, approved plugins are returned)
`authMethods`	array	Available auth methods with type, label, and default flag
`categories`	array	Category slugs and names
`toolCount`	number	Count of enabled tools
`connected`	boolean	Only present when `userId` is provided
`nextCursor`	string or null	Cursor for the next page when `limit` is used
`hasMore`	boolean	Whether another page is available