# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Flagsmith Admin dashboard API
  version: 1.0.0
extends: openapi/flagsmith-admin-dashboard-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/api/v1/admin/dashboard/organisations/'].get
  update:
    x-apievangelist-phrasing:
      intent: Review organisations on the admin dashboard
      effect: read
      questions:
      - Which organisations exist on my self-hosted Flagsmith instance?
      - Can an instance admin see every organisation from one dashboard view?
      instructions:
      - text: Show the admin dashboard list of organisations.
      - text: Pull the organisation breakdown for the instance admin view.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/dashboard/release-pipelines/'].get
  update:
    x-apievangelist-phrasing:
      intent: Review release pipelines on the admin dashboard
      effect: read
      questions:
      - What release pipelines are configured across the whole instance?
      - Can the admin dashboard show release pipeline usage?
      instructions:
      - text: Show the admin dashboard release pipelines report.
      - text: Give me the instance-wide release pipeline overview.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/dashboard/stale-flags/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find stale flags across the instance
      effect: read
      questions:
      - Which feature flags have gone stale and could be cleaned up?
      - How many stale flags are sitting across all our organisations?
      instructions:
      - text: Show the admin dashboard stale flags report.
      - text: List flags flagged as stale across the instance.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/dashboard/summary/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the admin dashboard summary
      effect: read
      questions:
      - What are the headline numbers for my Flagsmith instance?
      - Is there a single summary of instance activity for administrators?
      instructions:
      - text: Show the admin dashboard summary.
      - text: Give me the top-level instance stats for admins.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/dashboard/usage-trends/'].get
  update:
    x-apievangelist-phrasing:
      intent: See usage trends on the admin dashboard
      effect: read
      questions:
      - How has API usage on the instance trended over time?
      - Can I chart instance usage growth from the admin dashboard?
      instructions:
      - text: Show the admin dashboard usage trends.
      - text: Pull instance usage over time for the admin view.
      method: generated
      generated: '2026-09-26'