Plugins

Break down how the organization's skills, plugins or connectors are used

Changed on

Uses of one kind of item (kind: skills, plugins or connectors) over the last days UTC calendar days including today (7, 30 or 90; default 30), grouped by any of item, member and day (comma separated in groupBy; default item). item is the skill, plugin or connector id, member the organization member id and day the UTC date; dimensions not grouped by come back null. Filter to one member (memberId), the current members of one team (teamId), or one item (itemId). A team view counts its members' past uses by their current team. Every skill load and connector call counts once. Plugins count their skills' loads plus their Workflows' runs. failures counts failed connector calls and failed Workflow runs; it is null for skills. people counts distinct members in the row. sources splits uses by what started them (agent, workflow, automation, app, artifact); a missing key is zero. Only used items appear; ids are resolved to names by the caller. At most 10000 rows: a larger result answers 422 library_usage_too_many_rows without truncation. Members with the usage_analytics.view permission only (owners and admins by default).

get/v1/library-usage

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/library-usage
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

kind'skills' | 'plugins' | 'connectors' required
days'7' | '30' | '90'
groupBystring
memberIdstring
teamIdstring
itemIdstring

Response

Library usage breakdown

kind'skills' | 'plugins' | 'connectors' required
daysinteger required
fromstring date required
tostring date required
timezone'UTC' required
groupBystring[] required
trackingSincestring date-time nullable required

Changes