One plugin by id [read]

Changed on

name is a Plugin id (app:gmail, tool:exa.web, chat:slack, bundle:review-kit, skill:skl_…, mcp:<sha8>, mac:meetings, browser:mine); a bare name is a plugin bundle's (the same as bundle:<name>). Read through the same sources as GET /plugins?view=…; an app nobody connected is looked up in the connector catalog. Any id of a merged product (chat:slack, app:slack, tool:code-review) answers the product under its first id (app:slack_v2, app:github). unavailable names this plugin's sources when they could not be read. Once the workspace has the plugin, used_by names the agents that use it: every saved agent that has not switched it off (all is true when none has; a Mac feature or browser login is used by every agent, one the workspace switched off by none). A bundle's name is its marketplace display name, or its name in title case. 404 not_found when no source knows the id.

get/plugins/{name}

Request

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

Path parameters

namestring required

Query parameters

agent_idstring

Read it as this agent sees it

session_idstring

Read it as this chat sees it

Response

OK

idstring required

<source>:<key>: app:gmail, tool:dataforseo.serp, chat:slack, bundle:review-kit, skill:skl_…, mcp:<first 8 hex of the address's sha256>, mac:meetings, browser:mine.

namestring required
descriptionstring required

One line

status'added' | 'needs_you' | 'available' | 'off' required
scope'me' | 'workspace' required
usesstring[] required
aliasesstring[]

One product offered by several sources (Slack as a connected app and as a chat app; GitHub and its code review tool) is one plugin under its first id; these are its other ids, which still answer GET /plugins/{id} and still count in off lists

Changes