---
title: "One feature's use and outcomes by organization"
method: GET
path: "/v1/admin/feature-usage/{key}"
tags: ["Admin"]
---

# One feature's use and outcomes by organization

`GET /v1/admin/feature-usage/{key}`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/admin/feature-usage/{key}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

The same counts as GET /v1/admin/feature-usage for one feature, plus failed and skipped runs by reason code and one row per organization that used it, has outcomes in the range or overrides it: its name, whether the feature is on for it now, members using it, last use and its outcome totals. At most 200 organizations, busiest first. Counts only. Platform administrators only.

## Path parameters

- `key` string, required

## Query parameters

- `range` '7d' | '30d'

## Response `200`

Feature outcomes returned.

- AdminFeatureOutcomeDetail
  - `range` '7d' | '30d', required
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `organizations` integer, required
  - `feature` object, required
    - `key` 'libraryDetailBreadcrumbs' | 'desktopUpdateDownloadWindow' | 'nativeAffordanceCodeMode' | 'libraryConnectorNavigation' | 'mcpAppLibraries' | 'autoRouter' | 'gatewayProviderTest' | 'settledSessions' | 'mermaidZoom' | 'administratorRecovery' | 'nativeDictation' | 'sandboxOrgs' | 'connectionMcpServers' | 'slackSendAsBot' | 'liveProviderSync' | 'managedDeployments' | 'workbotDocuments' | 'workbotDocumentEditing' | 'workbotWorkspaceAssistant' | 'workbotProactive' | 'workbotAgentHealthView' | 'workbotAgentLibrary' | 'workbotIncludedModels' | 'workbotUsageRecovery' | 'automationCalendar' | 'automationIntervalSchedules' | 'automationCalendarTriggers' | 'computerUse' | 'computerUseBackground' | 'browserUse' | 'browserDemonstrations' | 'browserLiveView' | 'browserFloatingView' | 'remoteComputers' | 'sandboxGateway' | 'remoteSessionSubagents' | 'remoteSessionThreadView' | 'activationChecklist' | 'connectStandardTools' | 'connectEngineTools' | 'teamPlan' | 'selfServeEnterprise' | 'gatewayProviderAuthErrors' | 'providerCredentialStatus' | 'outlookAttachments' | 'sessionTokenHashing' | 'lastUsedSignIn' | 'expandedMcpPresets' | 'analyticsDailyTrends' | 'gatewayProviderRemovalLimits' | 'guidedSlackSetup' | 'libraryConnectorOrgSetup', required
    - `organizationsOn` integer, required
    - `membersUsing` integer, required
    - `lastUsedAt` string, date-time, nullable, required
    - `health` object, required
      - `status` 'not_used' | 'in_use' | 'healthy' | 'failing' | 'limited' | 'mostly_skipped', required
      - `count` integer, nullable, required
    - `outcomes` object, nullable, required
      - `runs` integer, required
      - `succeeded` integer, required
      - `failed` integer, required
      - `skipped` integer, required
      - `delivered` integer, nullable, required
      - `limited` integer, nullable, required
      - `lastRunAt` string, date-time, nullable, required
      - `unit` 'run' | 'meeting' | 'check' | 'message', required
      - `days` object[], required
        - `day` string, required
        - `runs` integer, required
        - `failed` integer, required
      - `coverage` object, nullable, required
        - `from` string, date-time, required
        - `counts` 'all' | 'failed', required
    - `reasons` object[], required
      - `reason` string, required
      - `outcome` 'failed' | 'skipped', required
      - `count` integer, required
    - `byOrganization` object[], required
      - `organizationId` string, required
      - `name` string, required
      - `enabled` boolean, required
      - `membersUsing` integer, required
      - `lastUsedAt` string, date-time, nullable, required
      - `outcomes` object, nullable, required
        - `runs` integer, required
        - `succeeded` integer, required
        - `failed` integer, required
        - `skipped` integer, required
        - `delivered` integer, nullable, required
        - `limited` integer, nullable, required
        - `lastRunAt` string, date-time, nullable, required
  - `generatedAt` string, date-time, required

## Other responses

- `400`: Unknown feature or invalid range.
- `401`: Sign in required.
- `403`: Platform administrator required.
- `404`: The feature is not part of this deployment.

## Changes

- **2026-10-29** `93c386b4754d`: 1 warning
  - added the new `libraryDetailBreadcrumbs` enum value to the `feature/key` response property for the response status `200`
- **2026-10-29** `5bd253fbca6a`: 3 warning
  - added the new `gatewayProviderRemovalLimits` enum value to the `feature/key` response property for the response status `200`
  - added the new `guidedSlackSetup` enum value to the `feature/key` response property for the response status `200`
  - added the new `libraryConnectorOrgSetup` enum value to the `feature/key` response property for the response status `200`
- **2026-10-29** `bd67819c44d2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/admin/feature-usage/:key/get.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/93c386b4754d?raw)