# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Sentry Discover API
  version: 1.0.0
extends: openapi/sentry-system-discover-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['/organizations/{organization_id_or_slug}/discover/saved/'].get
  update:
    x-apievangelist-phrasing:
      intent: List saved Discover queries
      effect: read
      questions:
      - Which Discover queries has my team saved?
      - Can I search saved queries by name and sort them?
      instructions:
      - text: List saved Discover queries in {org}.
        slots:
          org: path.organization_id_or_slug
      - text: Find saved queries in {org} matching {query}, sorted by {sortBy}.
        slots:
          org: path.organization_id_or_slug
          query: query.query
          sortBy: query.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/discover/saved/'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a new Discover query
      effect: write
      questions:
      - How do I save a Discover query so I can reuse it?
      - What fields are required when saving a query?
      instructions:
      - text: Save a Discover query named {name} in {org} with fields {fields}.
        slots:
          name: requestBody.name
          org: path.organization_id_or_slug
          fields: requestBody.fields
      - text: Save query {name} with fields {fields}, filter {query}, over range {range}.
        slots:
          name: requestBody.name
          fields: requestBody.fields
          query: requestBody.query
          range: requestBody.range
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/discover/saved/{query_id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a saved Discover query
      effect: read
      questions:
      - What columns and filters does a saved query use?
      - Can I open one saved Discover query by its ID?
      instructions:
      - text: Show saved Discover query {query_id} in {org}.
        slots:
          query_id: path.query_id
          org: path.organization_id_or_slug
      - text: Fetch the definition of saved query {query_id}.
        slots:
          query_id: path.query_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/discover/saved/{query_id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a saved Discover query
      effect: write
      questions:
      - How do I change the filter on a query I saved earlier?
      - Can I update the sort order of a saved query?
      instructions:
      - text: Change the filter of saved query {query_id} in {org} to {query}.
        slots:
          query_id: path.query_id
          org: path.organization_id_or_slug
          query: requestBody.query
      - text: Update saved query {query_id} to order by {orderby}.
        slots:
          query_id: path.query_id
          orderby: requestBody.orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organization_id_or_slug}/discover/saved/{query_id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a saved Discover query
      effect: destructive
      questions:
      - How do I remove a saved query from Discover?
      - Does deleting a saved query affect anyone else's view?
      instructions:
      - text: Delete saved Discover query {query_id} from {org}.
        slots:
          query_id: path.query_id
          org: path.organization_id_or_slug
      - text: Remove saved query {query_id}.
        slots:
          query_id: path.query_id
      method: generated
      generated: '2026-09-26'