Everything agents can use, as one Plugin list; or the installed plugin bundles [read]

Changed on

With view, one list of Plugins over every source: connected apps (yours, shared with the workspace, the workspace's services), gateway tools (priced from the gateway's endpoint directory), chat apps, plugin bundles, standalone skills, custom MCP servers (vault secrets with a server address and servers agents declare), browser logins and the Mac app's plugins. yours is what is added, off or waiting on the person (those first); discover is what can still be added, without anything yours lists (with source, that source's whole catalog, added ones marked), paged through the connector catalog with cursor (a cursor from other filters is 400 invalid_cursor). A source that cannot be read is named in unavailable and the rest still answer. A workspace key lists only what the workspace holds; a person's own apps, chat apps and Macs need the person's own key. One product is one plugin: an app and a chat app (or a tool) of the same product are listed once, under the product's first id with the others as aliases, needs_you when any part needs the person, else added when any part is added; source= lists that source alone, unmerged, by each plugin's own id. Without view this answers the installed plugin bundles exactly as before: each bundle's name and the workspace skills named plugin:<plugin>/<part> it installed.

get/plugins

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/plugins
  • Auth
    HTTP bearer

Query parameters

view'yours' | 'discover'

Omit for the installed plugin bundles

qstring

Search name, line and provider

use'work_apps' | 'search_data' | 'create_media' | 'message' | 'this_mac' | 'skills'
cursorstring

discover only: a page's next_cursor

source'app' | 'tool' | 'chat' | 'bundle' | 'skill' | 'mcp' | 'mac' | 'browser'

Only this source's plugins

agent_idstring

yours only: what this agent can use. A plugin switched off for it reads off, and layers.agent is its list

session_idstring

yours only: what this chat can use (its agent's switches and its own). off_for.session and layers.session say what the chat switched off

includestring

With view, a comma-separated list of connector rows to answer beside the list, each exactly as its store reads it: connections (your own connected accounts as connections, and the credit you earned by connecting as credit), granted (connections other people granted to this credential, which POST /plugins/{id}/call may call through), shared (every connection you share with a workspace, with the calls agents made through it) and services (the workspace's installed services). 400 invalid_request for another name.

Response

OK

OR

Changes