# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LaunchDarkly Dev Server Debug Sessions API
  version: 1.0.0
extends: openapi/launchdarkly-debug-sessions-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: 3
- target: $.paths['/debug-sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List debug sessions with event counts
      effect: read
      questions:
      - What debug sessions do I have and how many events does each hold?
      - Can I page through my debug sessions?
      instructions:
      - text: List all debug sessions.
      - text: Show {limit} debug sessions starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/debug-sessions/{debugSessionKey}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a debug session and its events
      effect: destructive
      questions:
      - How do I delete a debug session I no longer need?
      - Does removing a debug session also clear its events?
      instructions:
      - text: Delete debug session {debugSessionKey}.
        slots:
          debugSessionKey: path.debugSessionKey
      - text: Remove debug session {debugSessionKey} along with all its events.
        slots:
          debugSessionKey: path.debugSessionKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/debug-sessions/{debugSessionKey}/events'].get
  update:
    x-apievangelist-phrasing:
      intent: Get events from a debug session
      effect: read
      questions:
      - How can I see the events captured in a specific debug session?
      - Can I filter a debug session's events by kind?
      instructions:
      - text: Get events for debug session {debugSessionKey}.
        slots:
          debugSessionKey: path.debugSessionKey
      - text: Show {kind} events from debug session {debugSessionKey}.
        slots:
          kind: query.kind
          debugSessionKey: path.debugSessionKey
      method: generated
      generated: '2026-09-26'